publish_message
Publish one or more messages to an Ably channel. Supports publishing a single message to a channel or batch publishing multiple messages to one or more channels simultaneously.
Use batch mode by providing multiple channel-message pairs for efficient multi-channel publishing.
get_channel_status
Get the status and occupancy details of a specific Ably channel, or list all active channels.
Use this to check if a channel is active, how many connections/subscribers/publishers/presence members it has, or to enumerate all active channels with an optional prefix filter.
revoke_tokens
Revoke previously issued Ably tokens matching specified targets. Targets can be client IDs or other token identifiers. All matching tokens issued before the specified time will be revoked.
manage_rules
List, create, update, or delete Ably integration rules using the Control API.
Rules define how events (messages, presence, lifecycle, occupancy) are forwarded to external services like HTTP webhooks, AWS Lambda, Kafka, Amazon Kinesis, SQS, AMQP, and more.
get_presence
Retrieve the current set of members present on an Ably channel. Returns all clients currently "present" with their optional status data. Can be filtered by client ID or connection ID.
manage_queues
List, create, or delete Ably message queues using the Control API.
Queues allow worker servers to consume realtime messages via AMQP or STOMP protocols without managing queueing infrastructure.
get_presence_history
Retrieve historical presence events from an Ably channel. Returns a log of all presence actions (enter, leave, update) that occurred within the specified time range.
manage_keys
List, create, update, or revoke Ably API keys using the Control API.
Keys can be created with channel-specific capabilities, allowing fine-grained access control per channel.
request_token
Issue a short-lived Ably token with fine-grained capabilities for client authentication. Tokens can be scoped to specific channels, operations, and client identities.
Use this to generate tokens for client-side applications instead of exposing your API key.
get_statistics
Retrieve application-level usage statistics from Ably, including message counts, connections, API requests, and more. Statistics can be aggregated by minute, hour, day, or month.
get_message_history
Retrieve historical messages from an Ably channel. Messages are persisted and can be queried by time range, with pagination support. Useful for retrieving messages missed while disconnected.
manage_apps
List, create, update, or delete Ably applications using the Control API.
Supports listing all apps in an account, creating new apps, updating app settings, and deleting apps.
manage_namespaces
List, create, update, or delete Ably channel namespaces using the Control API.
Namespaces define channel-level settings such as message persistence, push notification enablement, and TLS enforcement.
A namespace applies to all channels whose name starts with the namespace ID followed by a colon (e.g. namespace "chat" applies to channels "chat:room1", "chat:room2", etc.).
get_service_time
Retrieve Ably service time in milliseconds since the Unix epoch for clock synchronization and token request diagnostics.
get_control_statistics
Retrieve usage statistics for an account or app with a Control API token, including the full provider statistics entries.
who_am_i
Retrieve the Control API token metadata, its user, and its account. Discover the account ID before listing apps with manage_apps.