TaskrouterTask Queue

Create Task Queue

POST
/v1/Workspaces/{WorkspaceSid}/TaskQueues

Authorization

accountSid_authToken
AuthorizationBasic <token>

In: header

Path Parameters

WorkspaceSid*string

The SID of the Workspace that the new TaskQueue belongs to.

Match^WS[0-9a-fA-F]{32}$
Length34 <= length <= 34

Request Body

application/x-www-form-urlencoded

FriendlyName*string

A descriptive string that you create to describe the TaskQueue. For example Support-Tier 1, Sales, or Escalation.

TargetWorkers?string

A string that describes the Worker selection criteria for any Tasks that enter the TaskQueue. For example, '"language" == "spanish"'. The default value is 1==1. If this value is empty, Tasks will wait in the TaskQueue until they are deleted or moved to another TaskQueue. For more information about Worker selection, see Describing Worker selection criteria.

MaxReservedWorkers?integer

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.

TaskOrder?TaskQueueTaskOrder

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.

Value in

  • "FIFO"
  • "LIFO"
ReservationActivitySid?string

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

Match^WA[0-9a-fA-F]{32}$
Length34 <= length <= 34
AssignmentActivitySid?string

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

Match^WA[0-9a-fA-F]{32}$
Length34 <= length <= 34

Response Body

application/json

curl -X POST "https://example.com/v1/Workspaces/stringstringstringstringstringstri/TaskQueues" \  -H "Content-Type: application/x-www-form-urlencoded" \  -d 'AssignmentActivitySid=WAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&FriendlyName=friendly_name&MaxReservedWorkers=1&ReservationActivitySid=WAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&TargetWorkers=target_workers&OperatingUnitSid=OUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'
{  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",  "assignment_activity_name": "817ca1c5-3a05-11e5-9292-98e0d9a1eb73",  "assignment_activity_sid": "WAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",  "date_created": "2015-08-04T01:31:41Z",  "date_updated": "2015-08-04T01:31:41Z",  "friendly_name": "81f96435-3a05-11e5-9f81-98e0d9a1eb73",  "max_reserved_workers": 1,  "links": {    "assignment_activity": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Activities/WAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",    "reservation_activity": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Activities/WAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",    "workspace": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",    "statistics": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/TaskQueues/WQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Statistics",    "real_time_statistics": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/TaskQueues/WQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/RealTimeStatistics",    "cumulative_statistics": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/TaskQueues/WQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/CumulativeStatistics",    "list_statistics": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/TaskQueues/Statistics",    "bulk_real_time_statistics": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/TaskQueues/RealTimeStatistics"  },  "reservation_activity_name": "80fa2beb-3a05-11e5-8fc8-98e0d9a1eb73",  "reservation_activity_sid": "WAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",  "sid": "WQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",  "target_workers": null,  "task_order": "FIFO",  "url": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/TaskQueues/WQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",  "workspace_sid": "WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}