List task reservation
Tasks reserved for workers
Path parameters
-
The SID of the Workspace with the TaskReservation resources to read.
-
The SID of the reserved Task resource with the TaskReservation resources to read.
Query parameters
-
ReservationStatus string
Returns the list of reservations for a task with a specified ReservationStatus. Can be:
pending
,accepted
,rejected
, ortimeout
.Values are
pending
,accepted
,rejected
,timeout
,canceled
,rescinded
,wrapping
, orcompleted
. -
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 is1000
.
GET /v1/Workspaces/{WorkspaceSid}/Tasks/{TaskSid}/Reservations
curl \
-X GET https://taskrouter.twilio.com/v1/Workspaces/{WorkspaceSid}/Tasks/{TaskSid}/Reservations \
--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"
},
"reservations": [
{
"account_sid": "string",
"date_created": "2023-05-04T09:42:00+00:00",
"date_updated": "2023-05-04T09:42:00+00:00",
"links": {},
"reservation_status": "pending",
"sid": "string",
"task_sid": "string",
"url": "https://example.com",
"worker_name": "string",
"worker_sid": "string",
"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"
},
"reservations": [
{
"account_sid": "string",
"date_created": "2024-05-04T09:42:00+00:00",
"date_updated": "2024-05-04T09:42:00+00:00",
"links": {},
"reservation_status": "pending",
"sid": "string",
"task_sid": "string",
"url": "https://example.com",
"worker_name": "string",
"worker_sid": "string",
"workspace_sid": "string"
}
]
}