---
title: "Update queue"
method: PUT
path: "/api/relay/rest/queues/{id}"
tags: ["Queues"]
---

# Update queue

`PUT /api/relay/rest/queues/{id}`

Updates a queue.

#### 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](/docs/platform/your-signalwire-api-space).

## Path parameters

- `id` string, uuid, required — Universal Unique Identifier.

## Request body

- UpdateQueueRequest — Request body for updating a queue.
  - `name` string — The name of the queue.
  - `max_size` integer — The maximum number of callers allowed in the queue.

## Response `200`

The request has succeeded.

- QueueResponse — Response containing a single queue.
  - `id` string, uuid, required — Universal Unique Identifier.
  - `project_id` string, uuid, required — Universal Unique Identifier.
  - `friendly_name` string, required — The friendly name of the queue.
  - `max_size` integer — The maximum number of callers allowed in the queue.
  - `current_size` integer — The current number of callers in the queue.
  - `average_wait_time` integer — The average wait time in seconds.
  - `uri` string — The URL of this queue.
  - `date_created` string, date-time — Timestamp when the queue was created.
  - `date_updated` string, date-time — Timestamp when the queue was last updated.

## Other responses

- `400` — The request is invalid.
- `401` — Access is unauthorized.
- `422` — The request failed validation. See errors for details.
- `500` — An internal server error occurred.

---

[API](https://skmtc.net/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.net/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signalwire/signalwire-rest-api/versions/05c5164b85c7/schema)