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"
}