Push channels list

Use the ably push channels list command to list push channel subscriptions.

Synopsis

ably push channels list <channel-name> [options]

Arguments

channel-name

Required

The channel to list subscriptions for.

Options

--device-id

Filter subscriptions by device ID.

--client-id

Filter subscriptions by client ID.

--limit

The maximum number of subscriptions to retrieve. Defaults to 100.

--json

Output results as compact JSON. Mutually exclusive with --pretty-json.

--pretty-json

Output results in formatted JSON. Mutually exclusive with --json.

--verbose | -v

Enable verbose logging. Can be combined with --json or --pretty-json.

Examples

List all subscriptions for a channel:

ably push channels list "my-channel"

Filter subscriptions by device:

ably push channels list "my-channel" --device-id device-123

List push channel subscriptions in JSON format:

ably push channels list "my-channel" --json

See also

• Push — Explore all ably push commands.
• CLI reference — Full list of available commands.