Path parameters
-
The SID of the Workspace resource to update.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^WS[0-9a-fA-F]{32}$
.
Body
-
The SID of the Activity that will be used when new Workers are created in the Workspace.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^WA[0-9a-fA-F]{32}$
. -
The URL we should call when an event occurs. See Workspace Events for more information. This parameter supports Twilio's Webhooks (HTTP callbacks) Connection Overrides.
-
The list of Workspace events for which to call event_callback_url. For example if
EventsFilter=task.created,task.canceled,worker.activity.update
, then TaskRouter will call event_callback_url only when a task is created, canceled, or a Worker activity is updated. -
A descriptive string that you create to describe the Workspace resource. For example:
Sales Call Center
orCustomer Support Team
. -
Whether to enable multi-tasking. Can be:
true
to enable multi-tasking, orfalse
to disable it. However, all workspaces should be maintained as multi-tasking. There is no default when omitting this parameter. A multi-tasking Workspace can't be updated to single-tasking unless it is not a Flex Project and another (legacy) single-tasking Workspace exists. Multi-tasking allows Workers to handle multiple Tasks simultaneously. In multi-tasking mode, each Worker can receive parallel reservations up to the per-channel maximums defined in the Workers section. In single-tasking mode (legacy mode), each Worker will only receive a new reservation when the previous task is completed. Learn more at Multitasking. -
The SID of the Activity that will be assigned to a Worker when a Task reservation times out without a response.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^WA[0-9a-fA-F]{32}$
. -
The type of TaskQueue to prioritize when Workers are receiving Tasks from both types of TaskQueues. Can be:
LIFO
orFIFO
and the default isFIFO
. For more information, see Queue Ordering.Values are
FIFO
orLIFO
.
curl \
--request POST 'https://taskrouter.twilio.com/v1/Workspaces/{Sid}' \
--user "username:password" \
--header "Content-Type: application/x-www-form-urlencoded" \
--data 'FriendlyName=friendly_name&EventCallbackUrl=%2Fexample&DefaultActivitySid=WAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&TimeoutActivitySid=WAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&AttentionRoutingEnabled=false&DefaultAttentionProfileSid=WPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'
{"FriendlyName"=>"friendly_name", "EventCallbackUrl"=>"/example", "DefaultActivitySid"=>"WAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "TimeoutActivitySid"=>"WAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "AttentionRoutingEnabled"=>false, "DefaultAttentionProfileSid"=>"WPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}
{
"sid": "WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"url": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"links": {
"tasks": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Tasks",
"events": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Events",
"workers": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers",
"workflows": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workflows",
"activities": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Activities",
"statistics": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Statistics",
"task_queues": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/TaskQueues",
"task_channels": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/TaskChannels",
"real_time_statistics": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/RealTimeStatistics",
"cumulative_statistics": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/CumulativeStatistics"
},
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"date_created": "2016-08-01T22:10:40Z",
"date_updated": "2016-08-01T22:10:40Z",
"events_filter": null,
"friendly_name": "new",
"event_callback_url": "",
"multi_task_enabled": false,
"default_activity_sid": "WAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"timeout_activity_sid": "WAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"default_activity_name": "Offline",
"timeout_activity_name": "Offline",
"prioritize_queue_order": "FIFO",
"attention_routing_enabled": false,
"default_operating_unit_sid": "OUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"default_attention_profile_sid": "WPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
}