Update task reservation
Tasks reserved for workers
Path parameters
-
WorkspaceSid
string Required The SID of the Workspace with the TaskReservation resources to update.
-
TaskSid
string Required The SID of the reserved Task resource with the TaskReservation resources to update.
-
Sid
string Required The SID of the TaskReservation resource to update.
Body
-
Beep
string Whether to play a notification beep when the participant joins or when to play a beep. Can be:
true
,false
,onEnter
, oronExit
. The default value istrue
. -
BeepOnCustomerEntrance
boolean Whether to play a notification beep when the customer joins.
-
CallAccept
boolean Whether to accept a reservation when executing a Call instruction.
-
CallFrom
string The Caller ID of the outbound call when executing a Call instruction.
-
CallRecord
string Whether to record both legs of a call when executing a Call instruction or which leg to record.
-
CallStatusCallbackUrl
string(uri) The URL to call for the completed call event when executing a Call instruction.
-
CallTimeout
integer Timeout for call when executing a Call instruction.
-
CallTo
string The Contact URI of the worker when executing a Call instruction. Can be the URI of the Twilio Client, the SIP URI for Programmable SIP, or the E.164 formatted phone number, depending on the destination.
-
CallUrl
string(uri) TwiML URI executed on answering the worker's leg as a result of the Call instruction.
-
ConferenceRecord
string Whether to record the conference the participant is joining or when to record the conference. Can be:
true
,false
,record-from-start
, anddo-not-record
. The default value isfalse
. -
ConferenceRecordingStatusCallback
string(uri) The URL we should call using the
conference_recording_status_callback_method
when the conference recording is available. -
ConferenceRecordingStatusCallbackMethod
string(http-method) The HTTP method we should use to call
conference_recording_status_callback
. Can be:GET
orPOST
and defaults toPOST
.Values are
HEAD
,GET
,POST
,PATCH
,PUT
, orDELETE
. -
ConferenceStatusCallback
string(uri) The URL we should call using the
conference_status_callback_method
when the conference events inconference_status_callback_event
occur. Only the value set by the first participant to join the conference is used. Subsequentconference_status_callback
values are ignored. -
ConferenceStatusCallbackEvent
array[string] The conference status events that we will send to
conference_status_callback
. Can be:start
,end
,join
,leave
,mute
,hold
,speaker
.Values are
start
,end
,join
,leave
,mute
,hold
, orspeaker
. -
ConferenceStatusCallbackMethod
string(http-method) The HTTP method we should use to call
conference_status_callback
. Can be:GET
orPOST
and defaults toPOST
.Values are
HEAD
,GET
,POST
,PATCH
,PUT
, orDELETE
. -
ConferenceTrim
string How to trim the leading and trailing silence from your recorded conference audio files. Can be:
trim-silence
ordo-not-trim
and defaults totrim-silence
. -
DequeueFrom
string The Caller ID of the call to the worker when executing a Dequeue instruction.
-
DequeuePostWorkActivitySid
string The SID of the Activity resource to start after executing a Dequeue instruction.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^WA[0-9a-fA-F]{32}$
. -
DequeueRecord
string Whether to record both legs of a call when executing a Dequeue instruction or which leg to record.
-
DequeueStatusCallbackEvent
array[string] The Call progress events sent via webhooks as a result of a Dequeue instruction.
-
DequeueStatusCallbackUrl
string(uri) The Callback URL for completed call event when executing a Dequeue instruction.
-
DequeueTimeout
integer Timeout for call when executing a Dequeue instruction.
-
DequeueTo
string The Contact URI of the worker when executing a Dequeue instruction. Can be the URI of the Twilio Client, the SIP URI for Programmable SIP, or the E.164 formatted phone number, depending on the destination.
-
EarlyMedia
boolean Whether to allow an agent to hear the state of the outbound call, including ringing or disconnect messages. The default is
true
. -
EndConferenceOnCustomerExit
boolean Whether to end the conference when the customer leaves.
-
EndConferenceOnExit
boolean Whether to end the conference when the agent leaves.
-
From
string The Caller ID of the call to the worker when executing a Conference instruction.
-
Instruction
string The assignment instruction for reservation.
-
MaxParticipants
integer The maximum number of participants in the conference. Can be a positive integer from
2
to250
. The default value is250
. -
Muted
boolean Whether the agent is muted in the conference. The default is
false
. -
PostWorkActivitySid
string The new worker activity SID after executing a Conference instruction.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^WA[0-9a-fA-F]{32}$
. -
Record
boolean Whether to record the participant and their conferences, including the time between conferences. The default is
false
. -
RecordingChannels
string The recording channels for the final recording. Can be:
mono
ordual
and the default ismono
. -
RecordingStatusCallback
string(uri) The URL that we should call using the
recording_status_callback_method
when the recording status changes. -
RecordingStatusCallbackMethod
string(http-method) The HTTP method we should use when we call
recording_status_callback
. Can be:GET
orPOST
and defaults toPOST
.Values are
HEAD
,GET
,POST
,PATCH
,PUT
, orDELETE
. -
RedirectAccept
boolean Whether the reservation should be accepted when executing a Redirect instruction.
-
RedirectCallSid
string The Call SID of the call parked in the queue when executing a Redirect instruction.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^CA[0-9a-fA-F]{32}$
. -
RedirectUrl
string(uri) TwiML URI to redirect the call to when executing the Redirect instruction.
-
Region
string The region where we should mix the recorded audio. Can be:
us1
,ie1
,de1
,sg1
,br1
,au1
, orjp1
. -
ReservationStatus
string The new status of the reservation. Can be:
pending
,accepted
,rejected
, ortimeout
.Values are
pending
,accepted
,rejected
,timeout
,canceled
,rescinded
,wrapping
, orcompleted
. -
SipAuthPassword
string The SIP password for authentication.
-
SipAuthUsername
string The SIP username used for authentication.
-
StartConferenceOnEnter
boolean Whether to start the conference when the participant joins, if it has not already started. The default is
true
. Iffalse
and the conference has not started, the participant is muted and hears background music until another participant starts the conference. -
StatusCallback
string(uri) The URL we should call using the
status_callback_method
to send status information to your application. -
StatusCallbackEvent
array[string] The call progress events that we will send to
status_callback
. Can be:initiated
,ringing
,answered
, orcompleted
.Values are
initiated
,ringing
,answered
, orcompleted
. -
StatusCallbackMethod
string(http-method) The HTTP method we should use to call
status_callback
. Can be:POST
orGET
and the default isPOST
.Values are
HEAD
,GET
,POST
,PATCH
,PUT
, orDELETE
. -
Supervisor
string The Supervisor SID/URI when executing the Supervise instruction.
-
SupervisorMode
string The Supervisor mode when executing the Supervise instruction.
Values are
monitor
,whisper
, orbarge
. -
Timeout
integer Timeout for call when executing a Conference instruction.
-
To
string The Contact URI of the worker when executing a Conference instruction. Can be the URI of the Twilio Client, the SIP URI for Programmable SIP, or the E.164 formatted phone number, depending on the destination.
-
WaitMethod
string(http-method) The HTTP method we should use to call
wait_url
. Can beGET
orPOST
and the default isPOST
. When using a static audio file, this should beGET
so that we can cache the file.Values are
HEAD
,GET
,POST
,PATCH
,PUT
, orDELETE
. -
WaitUrl
string(uri) The URL we should call using the
wait_method
for the music to play while participants are waiting for the conference to start. The default value is the URL of our standard hold music. Learn more about hold music. -
WorkerActivitySid
string The new worker activity SID if rejecting a reservation.
Minimum length is
34
, maximum length is34
. Format should match the following pattern:^WA[0-9a-fA-F]{32}$
.
curl \
-X POST https://taskrouter.twilio.com/v1/Workspaces/{WorkspaceSid}/Tasks/{TaskSid}/Reservations/{Sid} \
--user "username:password" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "If-Match: string" \
-d 'Beep=string&BeepOnCustomerEntrance=true&CallAccept=true&CallFrom=string&CallRecord=string&CallStatusCallbackUrl=https%3A%2F%2Fexample.com&CallTimeout=42&CallTo=string&CallUrl=https%3A%2F%2Fexample.com&ConferenceRecord=string&ConferenceRecordingStatusCallback=https%3A%2F%2Fexample.com&ConferenceRecordingStatusCallbackMethod=HEAD&ConferenceStatusCallback=https%3A%2F%2Fexample.com&ConferenceStatusCallbackEvent=start&ConferenceStatusCallbackMethod=HEAD&ConferenceTrim=string&DequeueFrom=string&DequeuePostWorkActivitySid=string&DequeueRecord=string&DequeueStatusCallbackEvent=string&DequeueStatusCallbackUrl=https%3A%2F%2Fexample.com&DequeueTimeout=42&DequeueTo=string&EarlyMedia=true&EndConferenceOnCustomerExit=true&EndConferenceOnExit=true&From=string&Instruction=string&MaxParticipants=42&Muted=true&PostWorkActivitySid=string&Record=true&RecordingChannels=string&RecordingStatusCallback=https%3A%2F%2Fexample.com&RecordingStatusCallbackMethod=HEAD&RedirectAccept=true&RedirectCallSid=string&RedirectUrl=https%3A%2F%2Fexample.com&Region=string&ReservationStatus=pending&SipAuthPassword=string&SipAuthUsername=string&StartConferenceOnEnter=true&StatusCallback=https%3A%2F%2Fexample.com&StatusCallbackEvent=initiated&StatusCallbackMethod=HEAD&Supervisor=string&SupervisorMode=monitor&Timeout=42&To=string&WaitMethod=HEAD&WaitUrl=https%3A%2F%2Fexample.com&WorkerActivitySid=string'
# Headers
If-Match: string
# Payload
{
"Beep": "string",
"BeepOnCustomerEntrance": true,
"CallAccept": true,
"CallFrom": "string",
"CallRecord": "string",
"CallStatusCallbackUrl": "https://example.com",
"CallTimeout": 42,
"CallTo": "string",
"CallUrl": "https://example.com",
"ConferenceRecord": "string",
"ConferenceRecordingStatusCallback": "https://example.com",
"ConferenceRecordingStatusCallbackMethod": "HEAD",
"ConferenceStatusCallback": "https://example.com",
"ConferenceStatusCallbackEvent": [
"start"
],
"ConferenceStatusCallbackMethod": "HEAD",
"ConferenceTrim": "string",
"DequeueFrom": "string",
"DequeuePostWorkActivitySid": "string",
"DequeueRecord": "string",
"DequeueStatusCallbackEvent": [
"string"
],
"DequeueStatusCallbackUrl": "https://example.com",
"DequeueTimeout": 42,
"DequeueTo": "string",
"EarlyMedia": true,
"EndConferenceOnCustomerExit": true,
"EndConferenceOnExit": true,
"From": "string",
"Instruction": "string",
"MaxParticipants": 42,
"Muted": true,
"PostWorkActivitySid": "string",
"Record": true,
"RecordingChannels": "string",
"RecordingStatusCallback": "https://example.com",
"RecordingStatusCallbackMethod": "HEAD",
"RedirectAccept": true,
"RedirectCallSid": "string",
"RedirectUrl": "https://example.com",
"Region": "string",
"ReservationStatus": "pending",
"SipAuthPassword": "string",
"SipAuthUsername": "string",
"StartConferenceOnEnter": true,
"StatusCallback": "https://example.com",
"StatusCallbackEvent": [
"initiated"
],
"StatusCallbackMethod": "HEAD",
"Supervisor": "string",
"SupervisorMode": "monitor",
"Timeout": 42,
"To": "string",
"WaitMethod": "HEAD",
"WaitUrl": "https://example.com",
"WorkerActivitySid": "string"
}
# Headers
If-Match: string
# Payload
{
"Beep": "string",
"BeepOnCustomerEntrance": true,
"CallAccept": true,
"CallFrom": "string",
"CallRecord": "string",
"CallStatusCallbackUrl": "https://example.com",
"CallTimeout": 42,
"CallTo": "string",
"CallUrl": "https://example.com",
"ConferenceRecord": "string",
"ConferenceRecordingStatusCallback": "https://example.com",
"ConferenceRecordingStatusCallbackMethod": "HEAD",
"ConferenceStatusCallback": "https://example.com",
"ConferenceStatusCallbackEvent": [
"start"
],
"ConferenceStatusCallbackMethod": "HEAD",
"ConferenceTrim": "string",
"DequeueFrom": "string",
"DequeuePostWorkActivitySid": "string",
"DequeueRecord": "string",
"DequeueStatusCallbackEvent": [
"string"
],
"DequeueStatusCallbackUrl": "https://example.com",
"DequeueTimeout": 42,
"DequeueTo": "string",
"EarlyMedia": true,
"EndConferenceOnCustomerExit": true,
"EndConferenceOnExit": true,
"From": "string",
"Instruction": "string",
"MaxParticipants": 42,
"Muted": true,
"PostWorkActivitySid": "string",
"Record": true,
"RecordingChannels": "string",
"RecordingStatusCallback": "https://example.com",
"RecordingStatusCallbackMethod": "HEAD",
"RedirectAccept": true,
"RedirectCallSid": "string",
"RedirectUrl": "https://example.com",
"Region": "string",
"ReservationStatus": "pending",
"SipAuthPassword": "string",
"SipAuthUsername": "string",
"StartConferenceOnEnter": true,
"StatusCallback": "https://example.com",
"StatusCallbackEvent": [
"initiated"
],
"StatusCallbackMethod": "HEAD",
"Supervisor": "string",
"SupervisorMode": "monitor",
"Timeout": 42,
"To": "string",
"WaitMethod": "HEAD",
"WaitUrl": "https://example.com",
"WorkerActivitySid": "string"
}
{
"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"
}
{
"account_sid": "string",
"date_created": "2025-05-04T09:42:00Z",
"date_updated": "2025-05-04T09:42:00Z",
"links": {},
"reservation_status": "pending",
"sid": "string",
"task_sid": "string",
"url": "https://example.com",
"worker_name": "string",
"worker_sid": "string",
"workspace_sid": "string"
}