Path parameters
-
The SID of the Workspace with the Events to read. Returns only the Events that pertain to the specified Workspace.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^WS[0-9a-fA-F]{32}$
.
Query parameters
-
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.
-
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.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^WR[0-9a-fA-F]{32}$
. -
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.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^WQ[0-9a-fA-F]{32}$
. -
The SID of the Task with the Events to read. Returns only the Events that pertain to the specified Task.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^WT[0-9a-fA-F]{32}$
. -
The SID of the Worker with the Events to read. Returns only the Events that pertain to the specified Worker.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^WK[0-9a-fA-F]{32}$
. -
The SID of the Workflow with the Events to read. Returns only the Events that pertain to the specified Workflow.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^WW[0-9a-fA-F]{32}$
. -
The TaskChannel with the Events to read. Returns only the Events that pertain to the specified TaskChannel.
-
The SID of the Event resource to read.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^EV[0-9a-fA-F]{32}$
. -
How many resources to return in each list page. The default is 50, and the maximum is 1000.
Minimum value is
1
, maximum value is1000
. -
The page index. This value is simply for client state.
Minimum value is
0
. -
The page token. This is provided by the API.
curl \
--request GET 'https://taskrouter.twilio.com/v1/Workspaces/{WorkspaceSid}/Events' \
--user "username:password"
{
"meta": {
"key": "events",
"url": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Events?TaskQueueSid=WQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&StartDate=2008-01-02T00%3A00%3A00Z&EndDate=2008-01-03T00%3A00%3A00Z&WorkerSid=WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&EventType=reservation.created&TaskSid=WTaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&WorkflowSid=WWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&ReservationSid=WRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
"page": 0,
"page_size": 50,
"next_page_url": null,
"first_page_url": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Events?TaskQueueSid=WQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&StartDate=2008-01-02T00%3A00%3A00Z&EndDate=2008-01-03T00%3A00%3A00Z&WorkerSid=WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&EventType=reservation.created&TaskSid=WTaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&WorkflowSid=WWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&ReservationSid=WRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
"previous_page_url": null
},
"events": [
{
"sid": "EVaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"url": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Events/EVaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"source": "twilio",
"actor_sid": "WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"actor_url": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"actor_type": "workspace",
"event_data": {
"worker_sid": "WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"worker_name": "JustinWorker",
"workspace_sid": "WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"workspace_name": "WorkspaceName",
"worker_attributes": "{}",
"worker_activity_sid": "WAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"worker_activity_name": "Offline",
"worker_time_in_previous_activity": "26",
"worker_time_in_previous_activity_ms": "26123"
},
"event_date": "2015-02-07T00:32:41Z",
"event_type": "worker.activity",
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"description": "Worker JustinWorker updated to Idle Activity",
"resource_sid": "WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"resource_url": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"event_date_ms": 987654321111,
"resource_type": "worker",
"workspace_sid": "WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"source_ip_address": "1.2.3.4"
}
]
}
{
"meta": {
"key": "events",
"url": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Events?TaskQueueSid=WQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&StartDate=2008-01-02T00%3A00%3A00Z&EndDate=2008-01-03T00%3A00%3A00Z&WorkerSid=WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&EventType=reservation.created&TaskSid=WTaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&WorkflowSid=WWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&ReservationSid=WRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
"page": 0,
"page_size": 50,
"next_page_url": null,
"first_page_url": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Events?TaskQueueSid=WQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&StartDate=2008-01-02T00%3A00%3A00Z&EndDate=2008-01-03T00%3A00%3A00Z&WorkerSid=WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&EventType=reservation.created&TaskSid=WTaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&WorkflowSid=WWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&ReservationSid=WRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&PageSize=50&Page=0",
"previous_page_url": null
},
"events": []
}