← Tools Reference

Ably Control

Ably Control integration (Developer Tools). Imported from open-connector.

API key14 toolshttps://control.ably.net/v1
GET
ably_control_get_current_account
Retrieve the Ably Control API token, user, and account associated with the access token.

/me

GET
ably_control_get_account_stats
Retrieve account-level Ably statistics for the connected account or account ID.

/accounts/{accountId}/stats

7 parameters
ParamTypeRequiredDescription
accountIdstringrequiredThe Ably account ID.
appIdstringoptionalThe Ably application ID.
startintegeroptionalA Unix timestamp in milliseconds.
endintegeroptionalA Unix timestamp in milliseconds.
limitintegeroptionalThe maximum number of statistics records to return.
unitstringoptionalThe statistics aggregation unit.
directionstringoptionalThe pagination direction.
GET
ably_control_get_app_stats
Retrieve app-level Ably statistics for an Ably app.

/apps/{appId}/stats

7 parameters
ParamTypeRequiredDescription
accountIdstringoptionalThe Ably account ID.
appIdstringrequiredThe Ably application ID.
startintegeroptionalA Unix timestamp in milliseconds.
endintegeroptionalA Unix timestamp in milliseconds.
limitintegeroptionalThe maximum number of statistics records to return.
unitstringoptionalThe statistics aggregation unit.
directionstringoptionalThe pagination direction.
GET
ably_control_list_apps
List Ably apps in the connected account or supplied account ID.

/accounts/{accountId}/apps

1 parameter
ParamTypeRequiredDescription
accountIdstringrequiredThe Ably account ID.
POST
ably_control_create_app
Create an Ably app in the connected account or supplied account ID.

/accounts/{accountId}/apps

10 parameters
ParamTypeRequiredDescription
accountIdstringrequiredThe Ably account ID.
namestringrequiredThe app name.
statusstringoptionalThe app status.
tlsOnlybooleanoptionalWhether to enforce TLS for all connections.
fcmKeystringoptional
fcmServiceAccountstringoptional
fcmProjectIdstringoptional
apnsCertificatestringoptional
apnsPrivateKeystringoptional
apnsUseSandboxEndpointbooleanoptional
PATCH
ably_control_update_app
Update editable settings for an Ably app.

/apps/{appId}

10 parameters
ParamTypeRequiredDescription
appIdstringrequiredThe Ably application ID.
namestringoptionalThe app name.
statusstringoptionalThe app status.
tlsOnlybooleanoptionalWhether to enforce TLS for all connections.
fcmKeystringoptional
fcmServiceAccountstringoptional
fcmProjectIdstringoptional
apnsCertificatestringoptional
apnsPrivateKeystringoptional
apnsUseSandboxEndpointbooleanoptional
DELETE
ably_control_delete_app
Delete an Ably app by app ID.

/apps/{appId}

1 parameter
ParamTypeRequiredDescription
appIdstringrequiredThe Ably application ID.
GET
ably_control_list_keys
List API keys for an Ably app.

/apps/{appId}/keys

1 parameter
ParamTypeRequiredDescription
appIdstringrequiredThe Ably application ID.
POST
ably_control_create_key
Create an API key for an Ably app.

/apps/{appId}/keys

3 parameters
ParamTypeRequiredDescription
appIdstringrequiredThe Ably application ID.
namestringrequiredThe key name.
capabilityobjectrequiredAbly channel capabilities keyed by channel or resource name.
PATCH
ably_control_update_key
Update an Ably API key name or capability.

/apps/{appId}/keys/{keyId}

4 parameters
ParamTypeRequiredDescription
appIdstringrequiredThe Ably application ID.
keyIdstringrequiredThe Ably API key ID.
namestringoptionalThe key name.
capabilityobjectoptionalAbly channel capabilities keyed by channel or resource name.
POST
ably_control_revoke_key
Revoke an Ably API key by key ID.

/apps/{appId}/keys/{keyId}/revoke

2 parameters
ParamTypeRequiredDescription
appIdstringrequiredThe Ably application ID.
keyIdstringrequiredThe Ably API key ID.
GET
ably_control_list_queues
List queues for an Ably app.

/apps/{appId}/queues

1 parameter
ParamTypeRequiredDescription
appIdstringrequiredThe Ably application ID.
POST
ably_control_create_queue
Create a queue for an Ably app.

/apps/{appId}/queues

5 parameters
ParamTypeRequiredDescription
appIdstringrequiredThe Ably application ID.
namestringrequiredThe queue name.
regionstringrequiredThe queue region, such as eu-west-1-a.
ttlintegeroptionalThe message TTL in seconds.
maxLengthintegeroptionalThe maximum queue length.
DELETE
ably_control_delete_queue
Delete an Ably queue by queue ID.

/apps/{appId}/queues/{queueId}

2 parameters
ParamTypeRequiredDescription
appIdstringrequiredThe Ably application ID.
queueIdstringrequiredThe Ably queue ID.