---
title: "Creates or updates a queue."
method: PATCH
path: "/routing/queues/{queueId}"
---

# Creates or updates a queue.

`PATCH /routing/queues/{queueId}`

Creates or updates a queue.

## Path parameters

- `queueId` string, required

## Query parameters

- `api-version` string, required

## Headers

- `If-Match` string
- `If-Unmodified-Since` string, date-time-rfc7231

## Response `200`

The request has succeeded.

- RouterQueue — A queue that can contain jobs to be routed.
  - `etag` string, required — The ETag (or entity tag) HTTP response header is an identifier for a specific version of a resource. It lets caches be more efficient and save bandwidth, as a web server does not need to resend a full response if the content was not changed. It is a string of ASCII characters placed between double quotes, like "675af34563dc-tr34".
  - `id` string, required — Id of a queue.
  - `name` string — Friendly name of this queue.
  - `distributionPolicyId` string — Id of a distribution policy that will determine how a job is distributed to workers.
  - `labels` object — A set of key/value pairs that are identifying attributes used by the rules engines to make decisions. Values must be primitive values - number, string, boolean.
  - `exceptionPolicyId` string — Id of an exception policy that determines various job escalation rules.

## Other responses

- `201` — The request has succeeded and a new resource has been created as a result.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/communication-jobrouter.md) · [All operations](https://skmtc.net/azure/apis/communication-jobrouter/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/communication-jobrouter/versions/c06e8f55d8b7/schema)