Deletes queue specified by external ID

Overview

Use this API to delete a queue. This API allows administrators to delete only one queue at a time. Integrated queues can also be deleted using this API. For this API to execute successfully, the queue being deleted:

  • Must not be used in any workflows.
  • Must not be used in any chat entry points.
  • Must not be configured as default queue for any of the subtypes of calltrack activity.
  • Must not have any open activities.
  • Must not be the default chat transfer queue in the department.
  • Must not be the default exception queue of the department.

    Permissions

    All of the following are required:
  • If logged in user is a department user:
    • User must have 'Delete' permission on the queue being deleted.
  • If logged in user is a global user:
    • User must have 'Administer' permission on the department of queue being deleted.
    • User must have 'Manage partition resources' privilege.
SecurityoAuthUser or oAuthClient
Request
path Parameters
id
required
string

External ID

Examples:
Ext208920010
header Parameters
Accept-Language
required
string
Default: en-US

Language locale accepted by client (used for locale specific fields in resource representation and in error responses).

Enum: "en-US" "es-ES" "fr-FR" "it-IT" "de-DE" "nl-NL" "pt-BR" "pt-PT" "da-DK" "ru-RU" "fr-CA" "zh-CN" "ja-JP" "ko-KR" "sv-SE"
Responses
204

No content

400

Bad Request

401

Unauthorized

403

Forbidden

406

Not Acceptable

500

Internal server error

delete/queue/ext-id/{id}
Request samples
Response samples
application/json
{
  • "code": "400-101",
  • "developerMessage": "Unsupported query parameter(s) supplied: '<query_parameter>'."
}