← Tools Reference

Ably

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

API key10 toolshttps://main.realtime.ably.net
GET
ably_batch_presence
Query current presence for multiple Ably channels.

/presence

2 parameters
ParamTypeRequiredDescription
channelsarrayrequiredOne or more Ably channel names.
separatorstringoptionalThe separator used when channels is provided as a string.
GET
ably_batch_presence_history
Query presence history for multiple Ably channels.

/channels/{channel}/presence/history

7 parameters
ParamTypeRequiredDescription
channelsarrayrequiredOne or more Ably channel names.
separatorstringoptionalThe separator used when channels is provided as a string.
startintegeroptionalA timestamp in milliseconds since the Unix epoch.
endintegeroptionalA timestamp in milliseconds since the Unix epoch.
limitintegeroptionalThe maximum number of records to return.
directionstringoptionalThe Ably pagination direction.
channelstringrequiredPath parameter: channel
GET
ably_create_channel
Activate an Ably channel by retrieving its metadata.

/channels/{channel_id}

1 parameter
ParamTypeRequiredDescription
channel_idstringrequiredThe Ably channel ID or channel name.
DELETE
ably_delete_channel_subscription
Delete an Ably push notification subscription for a channel, device, or client.

/push/channelSubscriptions

3 parameters
ParamTypeRequiredDescription
channelstringoptionalThe Ably channel ID or channel name.
client_idstringoptionalThe Ably client ID to unsubscribe.
device_idstringoptionalThe Ably device ID to unsubscribe.
GET
ably_get_channel_details
Retrieve Ably metadata and occupancy details for one channel.

/channels/{channel_id}

1 parameter
ParamTypeRequiredDescription
channel_idstringrequiredThe Ably channel ID or channel name.
GET
ably_get_channel_history
Retrieve message history for one Ably channel.

/channels/{channel_id}/messages

5 parameters
ParamTypeRequiredDescription
channel_idstringrequiredThe Ably channel ID or channel name.
startintegeroptionalA timestamp in milliseconds since the Unix epoch.
endintegeroptionalA timestamp in milliseconds since the Unix epoch.
limitintegeroptionalThe maximum number of records to return.
directionstringoptionalThe Ably pagination direction.
GET
ably_get_presence_history
Retrieve presence history for one Ably channel.

/channels/{channel_id}/presence/history

5 parameters
ParamTypeRequiredDescription
channel_idstringrequiredThe Ably channel ID or channel name.
startintegeroptionalA timestamp in milliseconds since the Unix epoch.
endintegeroptionalA timestamp in milliseconds since the Unix epoch.
limitintegeroptionalThe maximum number of records to return.
directionstringoptionalThe Ably pagination direction.
GET
ably_get_service_time
Retrieve Ably service time in milliseconds since the Unix epoch.

/time

GET
ably_get_stats
Retrieve Ably application usage statistics.

/stats

5 parameters
ParamTypeRequiredDescription
startintegeroptionalA timestamp in milliseconds since the Unix epoch.
endintegeroptionalA timestamp in milliseconds since the Unix epoch.
limitintegeroptionalThe maximum number of records to return.
directionstringoptionalThe Ably pagination direction.
unitstringoptionalThe Ably statistics aggregation unit.
GET
ably_list_push_channel_subscriptions
List Ably push notification channel subscriptions.

/push/channelSubscriptions

5 parameters
ParamTypeRequiredDescription
channelstringoptionalThe Ably channel ID or channel name.
client_idstringoptionalFilter subscriptions by Ably client ID.
device_idstringoptionalFilter subscriptions by Ably device ID.
concat_filtersbooleanoptionalWhether to match either client_id or device_id when both are set.
limitintegeroptionalThe maximum number of records to return.