Path parameters
-
The SID of the Workspace that the new Worker belongs to.
Body
-
ActivitySid string
The SID of a valid Activity that will describe the new Worker's initial state. See Activities for more information. If not provided, the new Worker's initial state is the
default_activity_sid
configured on the Workspace.Minimum length is
34
, maximum length is34
. Format should match the following pattern:^WA[0-9a-fA-F]{32}$
. -
Attributes string
A valid JSON string that describes the new Worker. For example:
{ "email": "Bob@example.com", "phone": "+5095551234" }
. This data is passed to theassignment_callback_url
when TaskRouter assigns a Task to the Worker. Defaults to {}. -
A descriptive string that you create to describe the new Worker. It can be up to 64 characters long.
POST /v1/Workspaces/{WorkspaceSid}/Workers
curl \
-X POST https://taskrouter.twilio.com/v1/Workspaces/{WorkspaceSid}/Workers \
--user "username:password" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d 'ActivitySid=string&Attributes=string&FriendlyName=string'
Request example
{
"ActivitySid": "string",
"Attributes": "string",
"FriendlyName": "string"
}
Request examples
{
"ActivitySid": "string",
"Attributes": "string",
"FriendlyName": "string"
}
Response examples (201)
{
"account_sid": "string",
"activity_name": "string",
"activity_sid": "string",
"attributes": "string",
"available": true,
"date_created": "2023-05-04T09:42:00+00:00",
"date_status_changed": "2023-05-04T09:42:00+00:00",
"date_updated": "2023-05-04T09:42:00+00:00",
"friendly_name": "string",
"links": {},
"sid": "string",
"url": "https://example.com",
"workspace_sid": "string"
}
Response examples (201)
{
"account_sid": "string",
"activity_name": "string",
"activity_sid": "string",
"attributes": "string",
"available": true,
"date_created": "2024-05-04T09:42:00+00:00",
"date_status_changed": "2024-05-04T09:42:00+00:00",
"date_updated": "2024-05-04T09:42:00+00:00",
"friendly_name": "string",
"links": {},
"sid": "string",
"url": "https://example.com",
"workspace_sid": "string"
}