TaskRouter logs Events for each state change in the Workspace for the purpose of historical reporting and auditing; it keeps that data for 30 days. To learn more about what events to expect and how they work, please visit the Event Reference page.
Pagination is not supported under this resource. Please avoid usage of the page
query parameter.
account_sid
type: SID<AC>The SID of the Account that created the Event resource.
^AC[0-9a-fA-F]{32}$
34
34
actor_sid
type: SIDThe SID of the resource that triggered the event.
^[a-zA-Z]{2}[0-9a-fA-F]{32}$
34
34
resource_sid
type: SIDThe SID of the object the event is most relevant to, such as a TaskSid, ReservationSid, or a WorkerSid.
^[a-zA-Z]{2}[0-9a-fA-F]{32}$
34
34
resource_type
type: stringThe type of object the event is most relevant to, such as a Task, Reservation, or a Worker).
sid
type: SID<EV>The unique string that we created to identify the Event resource.
^EV[0-9a-fA-F]{32}$
34
34
workspace_sid
type: SID<WS>The SID of the Workspace that contains the Event.
^WS[0-9a-fA-F]{32}$
34
34
GET https://taskrouter.twilio.com/v1/Workspaces/{WorkspaceSid}/Events/{Sid}
WorkspaceSid
type: SID<WS>The SID of the Workspace with the Event to fetch.
^WS[0-9a-fA-F]{32}$
34
34
Sid
type: SID<EV>The SID of the Event resource to fetch.
^EV[0-9a-fA-F]{32}$
34
34
GET https://taskrouter.twilio.com/v1/Workspaces/{WorkspaceSid}/Events
WorkspaceSid
type: SID<WS>The SID of the Workspace with the Events to read. Returns only the Events that pertain to the specified Workspace.
^WS[0-9a-fA-F]{32}$
34
34
EndDate
type: string<date-time>Only include Events that occurred on or before this date, specified in GMT as an ISO 8601 date-time.
EventType
type: stringThe type of Events to read. Returns only Events of the type specified.
Minutes
type: integerThe 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.
ReservationSid
type: SID<WR>The SID of the Reservation with the Events to read. Returns only Events that pertain to the specified Reservation.
^WR[0-9a-fA-F]{32}$
34
34
StartDate
type: 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.
TaskQueueSid
type: SID<WQ>The SID of the TaskQueue with the Events to read. Returns only the Events that pertain to the specified TaskQueue.
^WQ[0-9a-fA-F]{32}$
34
34
TaskSid
type: SID<WT>The SID of the Task with the Events to read. Returns only the Events that pertain to the specified Task.
^WT[0-9a-fA-F]{32}$
34
34
WorkerSid
type: SID<WK>The SID of the Worker with the Events to read. Returns only the Events that pertain to the specified Worker.
^WK[0-9a-fA-F]{32}$
34
34
WorkflowSid
type: SID<WW>The SID of the Workflow with the Events to read. Returns only the Events that pertain to the specified Workflow.
^WW[0-9a-fA-F]{32}$
34
34
TaskChannel
type: stringThe TaskChannel with the Events to read. Returns only the Events that pertain to the specified TaskChannel.
Sid
type: SID<EV>The SID of the Event resource to read.
^EV[0-9a-fA-F]{32}$
34
34
PageSize
type: integerHow many resources to return in each list page. The default is 50, and the maximum is 1000.
1
Page
type: integerThe page index. This value is simply for client state.
0
If the StartDate
of the Events request is greater than 30 days in the past then the query will be serviced a 400
-error response.