Update worker channel
TODO: Resource-level docs
Path parameters
-
The SID of the Workspace with the WorkerChannel to update.
-
The SID of the Worker with the WorkerChannel to update.
-
The SID of the WorkerChannel to update.
Body
-
Available boolean
Whether the WorkerChannel is available. Set to
false
to prevent the Worker from receiving any new Tasks of this TaskChannel type. -
Capacity integer
The total number of Tasks that the Worker should handle for the TaskChannel type. TaskRouter creates reservations for Tasks of this TaskChannel type up to the specified capacity. If the capacity is 0, no new reservations will be created.
POST /v1/Workspaces/{WorkspaceSid}/Workers/{WorkerSid}/Channels/{Sid}
curl \
-X POST https://taskrouter.twilio.com/v1/Workspaces/{WorkspaceSid}/Workers/{WorkerSid}/Channels/{Sid} \
--user "username:password" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d 'Available=true&Capacity=42'
Request example
{
"Available": true,
"Capacity": 42
}
Request examples
{
"Available": true,
"Capacity": 42
}
Response examples (200)
{
"account_sid": "string",
"assigned_tasks": 42,
"available": true,
"available_capacity_percentage": 42,
"configured_capacity": 42,
"date_created": "2023-05-04T09:42:00+00:00",
"date_updated": "2023-05-04T09:42:00+00:00",
"sid": "string",
"task_channel_sid": "string",
"task_channel_unique_name": "string",
"url": "https://example.com",
"worker_sid": "string",
"workspace_sid": "string"
}
Response examples (200)
{
"account_sid": "string",
"assigned_tasks": 42,
"available": true,
"available_capacity_percentage": 42,
"configured_capacity": 42,
"date_created": "2024-05-04T09:42:00+00:00",
"date_updated": "2024-05-04T09:42:00+00:00",
"sid": "string",
"task_channel_sid": "string",
"task_channel_unique_name": "string",
"url": "https://example.com",
"worker_sid": "string",
"workspace_sid": "string"
}