TaskrouterWorker

List Worker

GET
/v1/Workspaces/{WorkspaceSid}/Workers

Authorization

accountSid_authToken
AuthorizationBasic <token>

In: header

Path Parameters

WorkspaceSid*string

The SID of the Workspace with the Workers to read.

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

Query Parameters

ActivityName?string

The activity_name of the Worker resources to read.

ActivitySid?string

The activity_sid of the Worker resources to read.

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

Whether to return only Worker resources that are available or unavailable. Can be true, 1, or yes to return Worker resources that are available, and false, or any value returns the Worker resources that are not available.

FriendlyName?string

The friendly_name of the Worker resources to read.

TargetWorkersExpression?string

Filter by Workers that would match an expression. In addition to fields in the workers' attributes, the expression can include the following worker fields: sid, friendly_name, activity_sid, or activity_name

TaskQueueName?string

The friendly_name of the TaskQueue that the Workers to read are eligible for.

TaskQueueSid?string

The SID of the TaskQueue that the Workers to read are eligible for.

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

Sorting parameter for Workers

PageSize?integer

How many resources to return in each list page. The default is 50, and the maximum is 1000.

Formatint64
Range1 <= value <= 1000
Page?integer

The page index. This value is simply for client state.

Range0 <= value
PageToken?string

The page token. This is provided by the API.

Response Body

application/json

curl -X GET "https://example.com/v1/Workspaces/stringstringstringstringstringstri/Workers?ActivityName=activity_name&ActivitySid=WAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&Available=available&FriendlyName=friendly_name&TargetWorkersExpression=target_workers_expression&TaskQueueName=task_queue_name&TaskQueueSid=WQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"

{  "meta": {    "page": 0,    "page_size": 50,    "first_page_url": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers?Available=available&TargetWorkersExpression=target_workers_expression&TaskQueueName=task_queue_name&ActivityName=activity_name&ActivitySid=WAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&TaskQueueSid=WQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&FriendlyName=friendly_name&PageSize=50&Page=0",    "previous_page_url": null,    "url": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers?Available=available&TargetWorkersExpression=target_workers_expression&TaskQueueName=task_queue_name&ActivityName=activity_name&ActivitySid=WAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&TaskQueueSid=WQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&FriendlyName=friendly_name&PageSize=50&Page=0",    "next_page_url": null,    "key": "workers"  },  "workers": [    {      "sid": "WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "friendly_name": "testWorker",      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "activity_sid": "WAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "activity_name": "Offline",      "workspace_sid": "WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "attributes": "{}",      "available": false,      "date_created": "2017-05-30T23:05:29Z",      "date_updated": "2017-05-30T23:05:29Z",      "date_status_changed": "2017-05-30T23:05:29Z",      "url": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",      "links": {        "channels": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Channels",        "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/Workers/Statistics",        "real_time_statistics": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/RealTimeStatistics",        "cumulative_statistics": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/CumulativeStatistics",        "worker_statistics": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Statistics",        "worker_channels": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Channels",        "reservations": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Reservations"      }    }  ]}