Sign in

v50

latestOpenAPI 3.0.1Apache 2.0raw.githubusercontent.com2026-02-056136556.2 KB
TaskrouterV1TaskReservation

post/v1/Workspaces/{WorkspaceSid}/Tasks/{TaskSid}/Reservations/{Sid}

Path parameters

WorkspaceSidstring required

The SID of the Workspace with the TaskReservation resources to update.

TaskSidstring required

The SID of the reserved Task resource with the TaskReservation resources to update.

Sidstring required

The SID of the TaskReservation resource to update.

Headers

If-Matchstring

The If-Match HTTP request header

Response

OK

account_sidstring nullable

The SID of the Account that created the TaskReservation resource.

date_createdstring date-time nullable

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

date_updatedstring date-time nullable

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

reservation_status'pending' | 'accepted' | 'rejected' | 'timeout' | 'canceled' | 'rescinded' | 'wrapping' | 'completed'

The current status of the reservation. Can be: pending, accepted, rejected, or timeout.

sidstring nullable

The unique string that we created to identify the TaskReservation resource.

task_sidstring nullable

The SID of the reserved Task resource.

worker_namestring nullable

The friendly_name of the Worker that is reserved.

worker_sidstring nullable

The SID of the reserved Worker resource.

workspace_sidstring nullable

The SID of the Workspace that this task is contained within.

urlstring uri nullable

The absolute URL of the TaskReservation reservation.

linksobject nullable

The URLs of related resources.