Push channels remove

Use the ably push channels remove command to remove a push channel subscription.

Synopsis

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

Arguments

channel-name

Required

The channel to remove the subscription from.

Options

--device-id

The device ID to unsubscribe. Exclusive with --client-id.

--client-id

The client ID to unsubscribe. Exclusive with --device-id.

--force | -f

Skip confirmation prompt. Required when using --json. The default is false.

--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

Remove a device subscription from a channel:

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

Remove a client subscription from a channel:

ably push channels remove "my-channel" --client-id client-1 --force

Remove a push channel subscription and output in JSON format:

ably push channels remove "my-channel" --device-id device-123 --json

See also

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