---
title: "PUT /v2/workers/{worker_id}"
method: PUT
path: "/v2/workers/{worker_id}"
tags: ["v2"]
---

# PUT /v2/workers/{worker_id}

`PUT /v2/workers/{worker_id}`

## Headers

- `apikey` string, required
- `Client-Agent` string
- `X-Fields` string, mask

## Request body

- ModifyWorkerInput
  - `maintenance` boolean — Set to true to put this worker into maintenance.
  - `maintenance_msg` string — if maintenance is True, you can optionally provide a message to be used instead of the default maintenance message, so that the owner is informed.
  - `paused` boolean — (Mods only) Set to true to pause this worker.
  - `info` string — You can optionally provide a server note which will be seen in the server details. No profanity allowed!
  - `name` string — When this is set, it will change the worker's name. No profanity allowed!
  - `team` string — The team towards which this worker contributes kudos. It an empty string ('') is passed, it will leave the worker without a team. No profanity allowed!

## Response `200`

Modify Worker

- ModifyWorker
  - `maintenance` boolean — The new state of the 'maintenance' var for this worker. When True, this worker will not pick up any new requests.
  - `paused` boolean — The new state of the 'paused' var for this worker. When True, this worker will not be given any new requests.
  - `info` string — The new state of the 'info' var for this worker.
  - `name` string — The new name for this this worker.
  - `team` string — The new team of this worker.

## Other responses

- `400` — Validation Error
- `401` — Invalid API Key
- `403` — Access Denied
- `404` — Worker Not Found

---

[API](https://skmtc.dev/haidra-org/apis/ai-horde.md) · [All operations](https://skmtc.dev/haidra-org/apis/ai-horde/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/haidra-org/ai-horde/revisions/dfeb0bedd935/schema)