List Queues
Changed onReturns 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.
Request
- Base URLhttps://api.talkdeskapp.com
- URLhttps://api.talkdeskapp.com/ccaas/queues
- AuthOAuth 2Authorization code: https://{account_name}.talkdeskid.com/oauth/authorizeToken URL: https://{account_name}.talkdeskid.com/oauth/token scopes: queues:read
Query parameters
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.
Desired page. Defaults to 1.
Quantity of queues to be listed on each page. May change the total number of pages for the same collection.
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>
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.
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
Optional policy to use when evaluating the request.
Response
Queues list successfully
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
headerrequest parameterX-Override-Policy
- breaking