List worker

GET /v1/Workspaces/{WorkspaceSid}/Workers

TODO: Resource-level docs

Path parameters

  • WorkspaceSid string Required

    The SID of the Workspace with the Workers to read.

Query parameters

  • The activity_name of the Worker resources to read.

  • The activity_sid of the Worker resources to read.

  • 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.

  • The friendly_name of the Worker resources to read.

  • Filter by Workers that would match an expression on a TaskQueue. This is helpful for debugging which Workers would match a potential queue.

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

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

  • PageSize integer

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

    Minimum value is 1, maximum value is 1000.

Responses

  • OK

    Hide response attributes Show response attributes object
    • meta object
      Hide meta attributes Show meta attributes object
    • workers array[object]
      Hide workers attributes Show workers attributes array[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}$.

      • activity_name string | null

        The friendly_name of the Worker's current Activity

      • activity_sid string | null

        The SID of the Worker's current Activity

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

      • attributes string | null

        The JSON string that describes the Worker

      • available boolean | null

        Whether the Worker is available to perform tasks

      • date_created string(date-time) | null

        The ISO 8601 date and time in GMT when the resource was created

      • date_status_changed string(date-time) | null

        The date and time in GMT of the last change to the Worker's activity

      • date_updated string(date-time) | null

        The ISO 8601 date and time in GMT when the resource was last updated

      • friendly_name string | null

        The string that you assigned to describe the resource

      • sid string | null

        The unique string that identifies the resource

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

      • url string(uri) | null

        The absolute URL of the Worker resource

      • workspace_sid string | null

        The SID of the Workspace that contains the Worker

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

GET /v1/Workspaces/{WorkspaceSid}/Workers
curl \
 -X GET https://taskrouter.twilio.com/v1/Workspaces/{WorkspaceSid}/Workers \
 --user "username:password"
Response examples (200)
{
  "meta": {
    "first_page_url": "https://example.com",
    "key": "string",
    "next_page_url": "https://example.com",
    "page": 42,
    "page_size": 42,
    "previous_page_url": "https://example.com",
    "url": "https://example.com"
  },
  "workers": [
    {
      "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 (200)
{
  "meta": {
    "first_page_url": "https://example.com",
    "key": "string",
    "next_page_url": "https://example.com",
    "page": 42,
    "page_size": 42,
    "previous_page_url": "https://example.com",
    "url": "https://example.com"
  },
  "workers": [
    {
      "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"
    }
  ]
}