Update task queue

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

TODO: Resource-level docs

Path parameters

  • WorkspaceSid string Required

    The SID of the Workspace with the TaskQueue to update.

  • Sid string Required

    The SID of the TaskQueue resource to update.

Body

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

    Minimum length is 34, maximum length is 34. Format should match the following pattern: ^WA[0-9a-fA-F]{32}$.

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

  • The maximum number of Workers to create reservations for the assignment of a task while in the queue. Maximum of 50.

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

    Minimum length is 34, maximum length is 34. Format should match the following pattern: ^WA[0-9a-fA-F]{32}$.

  • 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 queue until they are either deleted or moved to another queue. Additional examples on how to describing Worker selection criteria below.

  • How Tasks will be assigned to Workers. Can be: FIFO or LIFO and the default is FIFO. Use FIFO to assign the oldest task first and LIFO to assign the most recent task first. For more information, see Queue Ordering.

    Values are FIFO or LIFO.

Responses

  • OK

    Hide response attributes Show response attributes object
    • account_sid string | null

      The SID of the Account that created the resource

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

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

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

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^WA[0-9a-fA-F]{32}$.

    • date_created string(date-time) | null

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

    • date_updated string(date-time) | null

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

    • friendly_name string | null

      The string that you assigned to describe the resource

    • max_reserved_workers integer | null

      The maximum number of Workers to reserve

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

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

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^WA[0-9a-fA-F]{32}$.

    • sid string | null

      The unique string that identifies the resource

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^WQ[0-9a-fA-F]{32}$.

    • target_workers string | null

      A string describing the Worker selection criteria for any Tasks that enter the TaskQueue

    • task_order string | null

      How Tasks will be assigned to Workers

      Values are FIFO or LIFO.

    • url string(uri) | null

      The absolute URL of the TaskQueue resource

    • workspace_sid string | null

      The SID of the Workspace that contains the TaskQueue

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^WS[0-9a-fA-F]{32}$.

POST /v1/Workspaces/{WorkspaceSid}/TaskQueues/{Sid}
curl \
 -X POST https://taskrouter.twilio.com/v1/Workspaces/{WorkspaceSid}/TaskQueues/{Sid} \
 --user "username:password" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d 'AssignmentActivitySid=string&FriendlyName=string&MaxReservedWorkers=42&ReservationActivitySid=string&TargetWorkers=string&TaskOrder=FIFO'
Request example
{
  "AssignmentActivitySid": "string",
  "FriendlyName": "string",
  "MaxReservedWorkers": 42,
  "ReservationActivitySid": "string",
  "TargetWorkers": "string",
  "TaskOrder": "FIFO"
}
Request examples
{
  "AssignmentActivitySid": "string",
  "FriendlyName": "string",
  "MaxReservedWorkers": 42,
  "ReservationActivitySid": "string",
  "TargetWorkers": "string",
  "TaskOrder": "FIFO"
}
Response examples (200)
{
  "account_sid": "string",
  "assignment_activity_name": "string",
  "assignment_activity_sid": "string",
  "date_created": "2023-05-04T09:42:00+00:00",
  "date_updated": "2023-05-04T09:42:00+00:00",
  "friendly_name": "string",
  "links": {},
  "max_reserved_workers": 42,
  "reservation_activity_name": "string",
  "reservation_activity_sid": "string",
  "sid": "string",
  "target_workers": "string",
  "task_order": "FIFO",
  "url": "https://example.com",
  "workspace_sid": "string"
}
Response examples (200)
{
  "account_sid": "string",
  "assignment_activity_name": "string",
  "assignment_activity_sid": "string",
  "date_created": "2024-05-04T09:42:00+00:00",
  "date_updated": "2024-05-04T09:42:00+00:00",
  "friendly_name": "string",
  "links": {},
  "max_reserved_workers": 42,
  "reservation_activity_name": "string",
  "reservation_activity_sid": "string",
  "sid": "string",
  "target_workers": "string",
  "task_order": "FIFO",
  "url": "https://example.com",
  "workspace_sid": "string"
}