Sign in

v77

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-08-012528701.8 MB
Queues

Create queue

Creates a new queue.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Voice.

Learn more about API scopes.

post/api/relay/rest/queues

Request body

namestring

The name of the queue.

max_sizeinteger

The maximum number of callers allowed in the queue.

Example request

{
  "name": "Name 2",
  "max_size": 600
}

Response

The request has succeeded and a new resource has been created as a result.

idstring uuid required

Universal Unique Identifier.

project_idstring uuid required

Universal Unique Identifier.

friendly_namestring required

The friendly name of the queue.

max_sizeinteger

The maximum number of callers allowed in the queue.

current_sizeinteger

The current number of callers in the queue.

average_wait_timeinteger

The average wait time in seconds.

uristring

The URL of this queue.

date_createdstring date-time

Timestamp when the queue was created.

date_updatedstring date-time

Timestamp when the queue was last updated.

Example response

{
  "friendly_name": "test",
  "max_size": 5,
  "uri": "/api/relay/rest/queues/aae131db-214c-46f5-88b6-92004f8467cf"
}