v50

latestOpenAPI 3.0.1Apache 2.0raw.githubusercontent.com2026-02-056136556.2 KB
TaskrouterV1TaskQueue

post/v1/Workspaces/{WorkspaceSid}/TaskQueues/{Sid}

Path parameters

WorkspaceSidstring required

The SID of the Workspace with the TaskQueue to update.

Sidstring required

The SID of the TaskQueue resource to update.

Response

OK

account_sidstring nullable

The SID of the Account that created the TaskQueue resource.

assignment_activity_sidstring nullable

The SID of the Activity to assign Workers when a task is assigned for them.

assignment_activity_namestring nullable

The name of the Activity to assign Workers when a task is assigned for them.

date_createdstring date-time nullable

The date and time in GMT when the resource was created specified in RFC 2822 format.

date_updatedstring date-time nullable

The date and time in GMT when the resource was last updated specified in RFC 2822 format.

friendly_namestring nullable

The string that you assigned to describe the resource.

max_reserved_workersinteger

The maximum number of Workers to reserve for the assignment of a task in the queue. Can be an integer between 1 and 50, inclusive and defaults to 1.

reservation_activity_sidstring nullable

The SID of the Activity to assign Workers once a task is reserved for them.

reservation_activity_namestring nullable

The name of the Activity to assign Workers once a task is reserved for them.

sidstring nullable

The unique string that we created to identify the TaskQueue resource.

target_workersstring nullable

A string describing the Worker selection criteria for any Tasks that enter the TaskQueue. For example '"language" == "spanish"' If no TargetWorkers parameter is provided, Tasks will wait in the TaskQueue until they are either deleted or moved to another TaskQueue. Additional examples on how to describing Worker selection criteria below. Defaults to 1==1.

task_order'FIFO' | 'LIFO'

How Tasks will be assigned to Workers. Set this parameter to LIFO to assign most recently created Task first or FIFO to assign the oldest Task. Default is FIFO. Click here to learn more.

urlstring uri nullable

The absolute URL of the TaskQueue resource.

workspace_sidstring nullable

The SID of the Workspace that contains the TaskQueue.

linksobject nullable

The URLs of related resources.