Get Started

REST API: Members

The Members list resource is a subresource of a Queue instance resource. It represents the set of members currently in a queue.

A Members instance resource represents an individual queue member. Each member is addressed by its CallSid.

Member Instance Resource

This resource represents a single queue Member, identified by a CallSid. Alternatively you can address the front of the Queue by specifying Front.

Resource URI

A specific call in the queue:

/2010-04-01/Accounts/{AccountSid}/Queues/{QueueSid}/Members/{CallSid}

The front of the queue:

/2010-04-01/Accounts/{AccountSid}/Queues/{QueueSid}/Members/Front

Resource Properties

A Member resource is represented by the following properties:

Property Description
CallSid A 34 character string that uniquely identifies the call that is enqueued.
DateEnqueued The date that the member was enqueued, given in RFC 2822 format.
WaitTime The number of seconds the member has been in the queue.
Position This member's current position in the queue.

HTTP GET

You can either get a specific member by pointing to a particular CallSid or the front of the queue by specifying Front.

Example

HTTP POST

Posting a URL and Method to a Queue instance will dequeue a member from a queue and have the member's call begin executing the TwiML document at that URL.

You can address either an individual member by CallSid or the front of the queue by addressing Front.

When redirecting a member of a queue addressed by CallSid, only the first request will succeed and return a 200 response code. A second request will fail and return an appropriate 400 response code. When dequeuing the Front of the queue, the next call in the queue will be redirected.

Example 1: Dequeuing from the front of the queue
Example 2: Dequeuing a particular call

HTTP PUT

Not supported

HTTP DELETE

Not supported

Members List Resource

Resource URI

/2010-04-01/Accounts/{AccountSid}/Queues/{QueueSid}/Members

HTTP GET

Returns the list of members in the queue identified by {QueueSid}.

Example

HTTP POST

Not supported

HTTP PUT

Not supported

HTTP DELETE

Not supported