List event

GET /v1/Workspaces/{WorkspaceSid}/Events

TODO: Resource-level docs

Path parameters

  • WorkspaceSid string Required

    The SID of the Workspace with the Events to read. Returns only the Events that pertain to the specified Workspace.

Query parameters

  • EndDate string(date-time)

    Only include Events that occurred on or before this date, specified in GMT as an ISO 8601 date-time.

  • The type of Events to read. Returns only Events of the type specified.

  • Minutes integer

    The period of events to read in minutes. Returns only Events that occurred since this many minutes in the past. The default is 15 minutes. Task Attributes for Events occuring more 43,200 minutes ago will be redacted.

  • The SID of the Reservation with the Events to read. Returns only Events that pertain to the specified Reservation.

  • StartDate string(date-time)

    Only include Events from on or after this date and time, specified in ISO 8601 format. Task Attributes for Events older than 30 days will be redacted.

  • The SID of the TaskQueue with the Events to read. Returns only the Events that pertain to the specified TaskQueue.

  • TaskSid string

    The SID of the Task with the Events to read. Returns only the Events that pertain to the specified Task.

  • The SID of the Worker with the Events to read. Returns only the Events that pertain to the specified Worker.

  • The SID of the Workflow with the Events to read. Returns only the Events that pertain to the specified Workflow.

  • The TaskChannel with the Events to read. Returns only the Events that pertain to the specified TaskChannel.

  • Sid string

    The SID of the Event resource to read.

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

      • actor_sid string | null

        The SID of the resource that triggered the event

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

      • actor_type string | null

        The type of resource that triggered the event

      • actor_url string(uri) | null

        The absolute URL of the resource that triggered the event

      • description string | null

        A description of the event

      • Data about the event

      • event_date string(date-time) | null

        The time the event was sent

      • event_date_ms integer | null

        The time the event was sent in milliseconds

      • event_type string | null

        The identifier for the event

      • resource_sid string | null

        The SID of the object the event is most relevant to

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

      • resource_type string | null

        The type of object the event is most relevant to

      • resource_url string(uri) | null

        The URL of the resource the event is most relevant to

      • sid string | null

        The unique string that identifies the resource

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

      • source string | null

        Where the Event originated

      • source_ip_address string | null

        The IP from which the Event originated

      • url string(uri) | null

        The absolute URL of the Event resource

      • workspace_sid string | null

        The SID of the Workspace that contains the Event

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

    • meta object
      Hide meta attributes Show meta attributes object
GET /v1/Workspaces/{WorkspaceSid}/Events
curl \
 -X GET https://taskrouter.twilio.com/v1/Workspaces/{WorkspaceSid}/Events \
 --user "username:password"
Response examples (200)
{
  "events": [
    {
      "account_sid": "string",
      "actor_sid": "string",
      "actor_type": "string",
      "actor_url": "https://example.com",
      "description": "string",
      "event_date": "2023-05-04T09:42:00+00:00",
      "event_date_ms": 42,
      "event_type": "string",
      "resource_sid": "string",
      "resource_type": "string",
      "resource_url": "https://example.com",
      "sid": "string",
      "source": "string",
      "source_ip_address": "string",
      "url": "https://example.com",
      "workspace_sid": "string"
    }
  ],
  "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"
  }
}
Response examples (200)
{
  "events": [
    {
      "account_sid": "string",
      "actor_sid": "string",
      "actor_type": "string",
      "actor_url": "https://example.com",
      "description": "string",
      "event_date": "2024-05-04T09:42:00+00:00",
      "event_date_ms": 42,
      "event_type": "string",
      "resource_sid": "string",
      "resource_type": "string",
      "resource_url": "https://example.com",
      "sid": "string",
      "source": "string",
      "source_ip_address": "string",
      "url": "https://example.com",
      "workspace_sid": "string"
    }
  ],
  "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"
  }
}