Queues API

Returns a paginated list of queues configured for the account. Use this endpoint to browse available queues, search by name, filter by prompt, or sort results. Queues represent logical groupings used to route interactions to the appropriate agents.

get/ccaas/queues

Request

  • Base URL
    https://api.talkdeskapp.com
  • URL
    https://api.talkdeskapp.com/ccaas/queues
  • Auth
    OAuth 2
    Authorization code: https://{account_name}.talkdeskid.com/oauth/authorize
    Token URL: https://{account_name}.talkdeskid.com/oauth/token scopes: queues:read

Query parameters

namestring

Allows searching Queues by name.<br/><br/> To fetch queues whose name partially or totally match a given string (this will be case insensitive), fill in this query parameter with the string to search for.

pageinteger

Desired page. Defaults to 1.

per_pageinteger

Quantity of queues to be listed on each page. May change the total number of pages for the same collection.

idstring

Allows filtering by the Queue Id (only filtering by one id is allowed). <br/> If the <b>id</b> and <b>name</b> parameters are both filled in, the <b>id prevails</b> because it is the first rule. <br/><br/> To fetch a given queue, fill this query parameter with the Queue id.</a>

order_bystring

The order_by parameter allows you to sort the retrieved results. If not specified, the default sorting will be based on the most recent Queue update (updated_at). Sort by multiple fields is currently not supported.

Supported sort fields

  • name - Sort by queue name

Examples

  • order_by=name:desc - Retrieve results sorted by queue name in descending order.
prompt_idsstring

Allows filtering by Prompt Id(s). Supports one or more values, separated by commas.<br/><br/> To fetch queues that use specific Prompt Id(s), provide the Prompt Id(s) in this query parameter.<br/><br/> A queue matches when a requested Prompt Id is configured as its transfer waiting music, its voice waiting experience music, or its voice waiting experience message. Default music and text-to-speech messages are never matched. The total in the response counts every matching queue.

Headers

X-Override-Policy'queues.view' | 'queues.details.view' | 'reporting.live-dashboards.view-only' | 'reporting.live-dashboards' | 'dce.channels.sms.access' | 'dce.channels.chat.access' | 'dce.channels.digital-connect.access' | 'dce.channels.email.access' | 'dce.channels.facebook-messenger.access' | 'dce.channels.whatsapp.access' | 'agents.view' | 'teams.view' | 'voicemails.view' | 'calls.view' | 'prompts-management.view' | 'conversations.channels.voice.access'

Optional policy to use when evaluating the request.

Response

Queues list successfully

totalinteger required
countinteger required
pageinteger required
per_pageinteger required

Changes

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • info

      added the new optional header request parameter X-Override-Policy