Queue Members

Update a Queue Member

Dequeues a waiting caller and redirects the call to cXML instructions at the supplied URL. Identify the caller by Call SID, or use Front to dequeue the first caller. This is live call control; native Queue Members can inspect waiting calls but do not provide this cXML redirect operation.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Voice.

Learn more about API scopes.

post/Accounts/{AccountSid}/Queues/{QueueSid}/Members/{CallSid}

Path parameters

AccountSidstring uuid required

Universal Unique Identifier.

The unique identifier for the account this Queue is associated with.

QueueSidstring uuid required

Universal Unique Identifier.

The unique identifier for the queue.

CallSidstring required

The unique identifier for the call, or the special value 'Front' to reference the member at the front of the queue.

Response

The request has succeeded.

call_sidstring uuid required

Universal Unique Identifier.

account_sidstring uuid required

Universal Unique Identifier.

queue_sidstring uuid required

Universal Unique Identifier.

date_enqueuedstring required

The date and time, in RFC 2822 format, when the member was enqueued.

positioninteger required

The position of the member in the queue (1-indexed).

wait_timeinteger required

The wait time, in seconds, since the member was enqueued.

member_typestring required

The type of the queue member.

uristring required

The URI of this resource, relative to the API base URL.

Example response

{
  "date_enqueued": "Wed, 26 Sep 2018 18:00:00 +0000",
  "position": 1,
  "wait_time": 30,
  "member_type": "laml_call",
  "uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Queues/b3877c40-da60-4998-90ad-b792e98472qu/Members/b3877c40-da60-4998-90ad-b792e98472ca.json"
}

Changes

Changed in 6 of the 40 revisions of this API.10425

May 12, 20262916d5e3072e33See the full diff
- ▲
  the account_sid response's property type/format changed from string/uuid to / for status 200
  response-property-type-changed
- ▲
  the call_sid response's property type/format changed from string/uuid to / for status 200
  response-property-type-changed
- ▲
  the queue_sid response's property type/format changed from string/uuid to / for status 200
  response-property-type-changed
- ○
  added uuid to the account_sid response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added uuid to the call_sid response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added uuid to the queue_sid response property allOf list for the response status 200
  response-property-all-of-added
May 12, 20265344c0c93a4c16See the full diff
- ▲
  added 'unevaluatedProperties' constraint to the request body
  request-body-unevaluated-properties-added
- ○
  added 'unevaluatedProperties' constraint to the response body for the status 200
  response-body-unevaluated-properties-added
- ○
  added 'unevaluatedProperties' constraint to the response body for the status 400
  response-body-unevaluated-properties-added
- ○
  added 'unevaluatedProperties' constraint to the response body for the status 401
  response-body-unevaluated-properties-added
- ○
  added 'unevaluatedProperties' constraint to the response body for the status 404
  response-body-unevaluated-properties-added
- ○
  added 'unevaluatedProperties' constraint to the response body for the status 422
  response-body-unevaluated-properties-added
- ○
  added 'unevaluatedProperties' constraint to the response body for the status 503
  response-body-unevaluated-properties-added
Jan 19, 2026d5fbaaddfa3e2212See the full diff
- ▲
  added required request body
  request-body-added-required
- ▲
  the wait_time response's property type/format changed from string/ to integer/int32 for status 200
  response-property-type-changed
- ●
  deleted the query request parameter Method
  request-parameter-removed
- ●
  deleted the query request parameter Url
  request-parameter-removed
- ○
  for the path request parameter CallSid, the type/format was generalized from string/uuid to string/
  request-parameter-type-generalized
- ○
  added the non-success response with the status 400
  response-non-success-status-added
- ○
  added the non-success response with the status 422
  response-non-success-status-added
- ○
  added the non-success response with the status 503
  response-non-success-status-added
- ○
  the response property call_sid became required for the status 200
  response-property-became-required
- ○
  the response property date_enqueued became required for the status 200
  response-property-became-required
- ○
  the response property position became required for the status 200
  response-property-became-required
- ○
  the response property uri became required for the status 200
  response-property-became-required
- ○
  the response property wait_time became required for the status 200
  response-property-became-required
- ○
  added the required property account_sid to the response with the 200 status
  response-required-property-added
- ○
  added the required property member_type to the response with the 200 status
  response-required-property-added
- ○
  added the required property queue_sid to the response with the 200 status
  response-required-property-added
This revision also has 11 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jan 15, 202607f73f74a61d21See the full diff
- ▲
  added the new required query request parameter Url
  new-required-request-parameter
- ▲
  removed the request body
  request-body-removed
- ○
  added the new optional query request parameter Method
  new-optional-request-parameter
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jan 15, 20266b2611cfa74b1See the full diff
- ○
  the Method request property default value POST was added
  request-property-default-value-added
Jan 15, 20263c88f14db21e222See the full diff
- ▲
  added required request body
  request-body-added-required
- ▲
  the position response's property type/format changed from string/ to integer/int32 for status 200
  response-property-type-changed
- ●
  deleted the query request parameter Method
  request-parameter-removed
- ●
  deleted the query request parameter Url
  request-parameter-removed
- ○
  added the non-success response with the status 401
  response-non-success-status-added
- ○
  added the non-success response with the status 404
  response-non-success-status-added
This revision also has 14 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history