---
title: "Submit data for replace worker properties with the new properties"
method: PUT
path: "/workers/{id}"
---

# Submit data for replace worker properties with the new properties

`PUT /workers/{id}`

Required role: admin role 

Submit a worker ID and a list of worker properties to replace with current worker properties.

## Path parameters

- `id` integer, required

## Request body

- WorkerRequest — Represents a worker request.
  - `properties` object — Worker properties list

## Response `200`

Worker properties successfully replaced

## Other responses

- `400` — Bad request from the client
- `403` — Access is forbidden!
- `404` — No such worker
- `500` — The server were unable to process the request. See server-side logs for more details.

## Changes

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

- **2023-11-23** `d5ee0ae7ba00` — 1 info
  - added the non-success response with the status `403`
- **2023-11-20** `a90e50559d02` — 1 breaking, 1 info
  - request body became required
  - added the non-success response with the status `404`
- **2023-11-16** `96ccadc49889` — 1 info
  - endpoint added
- **2023-11-16** `d4cad3f34ce0` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/keyfactor/apis/signserver-rest-interface/changes/workers/:id/put.md)

---

[API](https://skmtc.dev/keyfactor/apis/signserver-rest-interface.md) · [All operations](https://skmtc.dev/keyfactor/apis/signserver-rest-interface/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/keyfactor/signserver-rest-interface/revisions/d1bc41f9bf6b/schema)