---
title: "Creates or updates a worker."
method: PATCH
path: "/routing/workers/{workerId}"
---

# Creates or updates a worker.

`PATCH /routing/workers/{workerId}`

Creates or updates a worker.

## Path parameters

- `workerId` 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.

- RouterWorker — An entity for jobs to be routed to.
  - `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 worker.
  - `state` 'active' | 'draining' | 'inactive' — Enums for worker states.
  - `queues` string[] — Collection of queue(s) that this worker can receive work from.
  - `capacity` integer — The total capacity score this worker has to manage multiple concurrent jobs.
  - `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.
  - `tags` object — A set of non-identifying attributes attached to this worker. Values must be primitive values - number, string, boolean.
  - `channels` RouterChannel[] — Collection of channel(s) this worker can handle and their impact on the workers capacity.
    - `channelId` string, required — Id of a channel.
    - `capacityCostPerJob` integer, required — The amount of capacity that an instance of a job of this channel will consume of the total worker capacity.
    - `maxNumberOfJobs` integer — The maximum number of jobs that can be supported concurrently for this channel. Value must be greater than zero.
  - `offers` RouterJobOffer[] — A list of active offers issued to this worker.
    - `offerId` string, required — Id of an offer.
    - `jobId` string, required — Id of the job.
    - `capacityCost` integer, required — The capacity cost consumed by the job offer.
    - `offeredAt` string, date-time — Timestamp when the offer was created in UTC.
    - `expiresAt` string, date-time — Timestamp when the offer will expire in UTC.
  - `assignedJobs` RouterWorkerAssignment[] — A list of assigned jobs attached to this worker.
    - `assignmentId` string, required — Id of the assignment.
    - `jobId` string, required — Id of the job assigned.
    - `capacityCost` integer, required — The amount of capacity this assignment has consumed on the worker.
    - `assignedAt` string, date-time, required — The assignment time of the job in UTC.
  - `loadRatio` number, double — A value indicating the workers capacity. A value of '1' means all capacity is consumed. A value of '0' means no capacity is currently consumed.
  - `availableForOffers` boolean — A flag indicating this worker is open to receive offers or not.
  - `maxConcurrentOffers` integer — If this is set, the worker will only receive up to this many new offers at a time.

## Other responses

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

## Changes

> 5 revisions in range; 1 could not be searched.

- **2026-07-13** `fe2019dcc5b0` — 4 info
  - api operation id `JobRouter_UpsertWorker` removed and replaced with `JobRouterOperations_UpsertWorker`
  - api tag `Workers` removed
  - added the new optional `header` request parameter `If-Match`
  - added the new optional `header` request parameter `If-Unmodified-Since`
- **2026-07-13** `1a6c28227c55` — 1 info
  - added the success response with the status `201`
- **2022-05-05** `8cbeaf5a7ce3` — 1 breaking, 5 warning, 2 info
  - removed the success response with the status `201`
  - the optional response header `ETag` removed for the status `200`
  - the optional response header `Last-Modified` removed for the status `200`
  - the optional response header `x-ms-error-code` removed for the status `default`
  - …4 more

[Change history](https://skmtc.dev/azure/apis/communication-jobrouter/changes/routing/workers/:workerId/patch.md)

---

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