zulip/templates/zerver/api/remove-subscriptions.md

Remove subscriptions

Unsubscribe yourself or other users from one or more streams.

DELETE {{ api_url }}/v1/users/me/subcriptions

Usage examples

• Python
• JavaScript
• curl

curl -X "DELETE" {{ api_url }}/v1/users/me/subscriptions \
    -u BOT_EMAIL_ADDRESS:BOT_API_KEY \
    -d 'subscriptions=["Denmark"]'

You may specify the principals argument like so:

curl -X "DELETE" {{ api_url }}/v1/users/me/subscriptions \
    -u BOT_EMAIL_ADDRESS:BOT_API_KEY \
    -d 'subscriptions=["Denmark"]' \
    -d 'principals=["ZOE@zulip.com"]'

Note: Unsubscribing another user from a stream requires administrative privileges.

{generate_code_example(python)|remove-subscriptions|example}

More examples and documentation can be found [here](https://github.com/zulip/zulip-js). ```js const zulip = require('zulip-js');

// Download zuliprc-dev from your dev server const config = { zuliprc: 'zuliprc-dev', };

zulip(config).then((client) => { // Unsubscribe from the stream "Denmark" const meParams = { subscriptions: JSON.stringify(['Denmark']), }; client.users.me.subscriptions.remove(meParams).then(console.log);

// Unsubscribe Zoe from the stream "Denmark"
const zoeParams = {
    subscriptions: JSON.stringify(['Denmark']),
    principals: JSON.stringify(['ZOE@zulip.org']),
};
client.users.me.subscriptions.remove(zoeParams).then(console.log);

});

</div>

</div>

</div>

## Arguments

{generate_api_arguments_table|arguments.json|remove-subscriptions.md}

#### Return values

* `removed`: A list of the names of streams which were unsubscribed from as
  a result of the query.

* `not_subscribed`: A list of the names of streams that the user is already
  unsubscribed from, and hence doesn't need to be unsubscribed.

#### Example response

A typical successful JSON response may look like:

{generate_code_example|remove-subscriptions|fixture}

A typical failed JSON response for when the target stream does not exist:

{generate_code_example|nonexistent-stream-error|fixture}