Update worker reservation
Current and past reservations for a worker
Path parameters
- 
    
  
The SID of the Workspace with the WorkerReservation resources to update.
Minimum length is
34, maximum length is34. Format should match the following pattern:^WS[0-9a-fA-F]{32}$. - 
    
  
The SID of the reserved Worker resource with the WorkerReservation resources to update.
Minimum length is
34, maximum length is34. Format should match the following pattern:^WK[0-9a-fA-F]{32}$. - 
    
  
The SID of the WorkerReservation resource to update.
Minimum length is
34, maximum length is34. Format should match the following pattern:^WR[0-9a-fA-F]{32}$. 
Body
- 
    
  
The current status of the reservation. Can be:
pending,accepted,rejected,timeout,canceled, orrescinded.Values are
pending,accepted,rejected,timeout,canceled,rescinded,wrapping, orcompleted. - 
    
  
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}$. - 
    
  
The assignment instruction for the reservation.
 - 
    
  
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}$. - 
    
  
The caller ID of the call to the worker when executing a Dequeue instruction.
 - 
    
  
Whether to record both legs of a call when executing a Dequeue instruction or which leg to record.
 - 
    
  
The timeout for call when executing a Dequeue instruction.
 - 
    
  
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.
 - 
    
  
The callback URL for completed call event when executing a Dequeue instruction.
 - 
    
  
The Caller ID of the outbound call when executing a Call instruction.
 - 
    
  
Whether to record both legs of a call when executing a Call instruction.
 - 
    
  
The timeout for a call when executing a Call instruction.
 - 
    
  
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.
 - 
    
  
TwiML URI executed on answering the worker's leg as a result of the Call instruction.
 - 
    
  
The URL to call for the completed call event when executing a Call instruction.
 - 
    
  
Whether to accept a reservation when executing a Call instruction.
 - 
    
  
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}$. - 
    
  
Whether the reservation should be accepted when executing a Redirect instruction.
 - 
    
  
TwiML URI to redirect the call to when executing the Redirect instruction.
 - 
    
  
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.
 - 
    
  
The caller ID of the call to the worker when executing a Conference instruction.
 - 
    
  
The URL we should call using the
status_callback_methodto send status information to your application. - 
    
  
The HTTP method we should use to call
status_callback. Can be:POSTorGETand the default isPOST.Values are
GETorPOST. - 
    
  
The call progress events that we will send to
status_callback. Can be:initiated,ringing,answered, orcompleted.Values are
initiated,ringing,answered, orcompleted. - 
    
  
The timeout for a call when executing a Conference instruction.
 - 
    
  
Whether to record the participant and their conferences, including the time between conferences. Can be
trueorfalseand the default isfalse. - 
    
  
Whether the agent is muted in the conference. Defaults to
false. - 
    
  
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. - 
    
  
Whether to start the conference when the participant joins, if it has not already started. Can be:
trueorfalseand the default istrue. Iffalseand the conference has not started, the participant is muted and hears background music until another participant starts the conference. - 
    
  
Whether to end the conference when the agent leaves.
 - 
    
  
The URL we should call using the
wait_methodfor 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. - 
    
  
The HTTP method we should use to call
wait_url. Can beGETorPOSTand the default isPOST. When using a static audio file, this should beGETso that we can cache the file.Values are
GETorPOST. - 
    
  
Whether to allow an agent to hear the state of the outbound call, including ringing or disconnect messages. The default is
true. - 
    
  
The maximum number of participants allowed in the conference. Can be a positive integer from
2to250. The default value is250. - 
    
  
The URL we should call using the
conference_status_callback_methodwhen the conference events inconference_status_callback_eventoccur. Only the value set by the first participant to join the conference is used. Subsequentconference_status_callbackvalues are ignored. - 
    
  
The HTTP method we should use to call
conference_status_callback. Can be:GETorPOSTand defaults toPOST.Values are
GETorPOST. - 
    
  
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. - 
    
  
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. - 
    
  
Whether to trim leading and trailing silence from your recorded conference audio files. Can be:
trim-silenceordo-not-trimand defaults totrim-silence. - 
    
  
The recording channels for the final recording. Can be:
monoordualand the default ismono. - 
    
  
The URL that we should call using the
recording_status_callback_methodwhen the recording status changes. - 
    
  
The HTTP method we should use when we call
recording_status_callback. Can be:GETorPOSTand defaults toPOST.Values are
GETorPOST. - 
    
  
The URL we should call using the
conference_recording_status_callback_methodwhen the conference recording is available. - 
    
  
The HTTP method we should use to call
conference_recording_status_callback. Can be:GETorPOSTand defaults toPOST.Values are
GETorPOST. - 
    
  
The region where we should mix the recorded audio. Can be:
us1,us2,ie1,de1,sg1,br1,au1, orjp1. - 
    
  
The SIP username used for authentication.
 - 
    
  
The SIP password for authentication.
 - 
    
  
The call progress events sent via webhooks as a result of a Dequeue instruction.
 - 
    
  
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}$. - 
    
  
Whether to end the conference when the customer leaves.
 - 
    
  
Whether to play a notification beep when the customer joins.
 - 
    
  
The jitter buffer size for conference. Can be:
small,medium,large,off. 
curl \
 --request POST 'https://taskrouter.twilio.com/v1/Workspaces/{WorkspaceSid}/Workers/{WorkerSid}/Reservations/{Sid}' \
 --user "username:password" \
 --header "Content-Type: application/x-www-form-urlencoded" \
 --header "If-Match: string" \
 --data 'ReservationStatus=accepted'
    {"ReservationStatus" => "accepted"}
{
  "sid": "WRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "url": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Reservations/WRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "links": {
    "task": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Tasks/WTaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "worker": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Workers/WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "workspace": "https://taskrouter.twilio.com/v1/Workspaces/WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  },
  "task_sid": "WTaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "attention": 0,
  "worker_sid": "WKaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "worker_name": "Doug",
  "date_created": "2014-05-14T10:50:02Z",
  "date_updated": "2014-05-15T16:03:42Z",
  "workspace_sid": "WSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "reservation_status": "accepted"
}