Sample - Twilio API
POST/2010-04-01/Accounts/{AccountSid}/Queues/{Sid}.json

Update a queue

Updates the configurable properties of a queue belonging to an account. Supply FriendlyName to change the queue description and MaxSize to change its call capacity; omitted fields retain their current values. The response contains the updated queue and its current operating metrics.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters · 2 body fields
AccountSidstringrequired
The account SID that created the queue. Must be a 34-character value matching `^AC[0-9a-fA-F]{32}$`.
Sidstringrequired
The unique queue SID to update. Must be a 34-character value matching `^QU[0-9a-fA-F]{32}$`.

Queue properties to update. Both fields can be omitted when no corresponding property needs to change.

FriendlyNamestringoptional
A descriptive string that you created to describe this resource. It can be up to 64 characters long.
MaxSizeintegeroptional
The maximum number of calls allowed to be in the queue. The default is 1000. The maximum is 5000.

1 status code
200Returns the updated queue object with its SID, account SID, friendly name, current size, maximum size, average wait time, resource URI, and creation and update timestamps.
date_updatedstringoptional
The date and time in GMT that this resource was last updated, specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
current_sizeintegeroptional
The number of calls currently in the queue.
Default:0
friendly_namestringoptional
A string that you assigned to describe this resource.
uristringoptional
The URI of this resource, relative to `https://api.twilio.com`.
account_sidstringoptional
The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this Queue resource.
average_wait_timeintegeroptional
The average wait time in seconds of the members in this queue. This is calculated at the time of the request.
Default:0
sidstringoptional
The unique string that that we created to identify this Queue resource.
date_createdstringoptional
The date and time in GMT that this resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
max_sizeintegeroptional
The maximum number of calls that can be in the queue. The default is 1000 and the maximum is 5000.
Default:0

Error handling

AccountSid must be a 34-character account SID matching the AC prefix format, and Sid must be a 34-character queue SID matching the QU prefix format. FriendlyName can contain up to 64 characters, and MaxSize cannot exceed 5000; the default maximum queue size is 1000 when it is not set.