zulip/templates/zerver/api/delete-queue.md

62 lines
1.2 KiB
Markdown

# Delete a queue
{generate_api_description(/events:delete)}
## Usage examples
{start_tabs}
{tab|python}
{generate_code_example(python)|/events:delete|example}
{tab|js}
More examples and documentation can be found [here](https://github.com/zulip/zulip-js).
```js
const zulip = require('zulip-js');
// Pass the path to your zuliprc file here.
const config = {
zuliprc: 'zuliprc',
};
zulip(config).then((client) => {
// Register a queue
const queueParams = {
event_types: ['message']
};
client.queues.register(queueParams).then((res) => {
// Delete a queue
const deregisterParams = {
queue_id: res.queue_id,
};
client.queues.deregister(deregisterParams).then(console.log);
});
});
```
{tab|curl}
{generate_code_example(curl)|/events:delete|example}
{end_tabs}
## Arguments
{generate_api_arguments_table|zulip.yaml|/events:delete}
## Response
#### Example response
A typical successful JSON response may look like:
{generate_code_example|/events:delete|fixture(200)}
A typical JSON response for when the `queue_id` is non-existent or the
associated queue has already been deleted:
{generate_code_example|/events:delete|fixture(400)}