---
title: "Update a worker"
method: POST
path: "/api/workers/{id}"
tags: ["Workers"]
---

# Update a worker

`POST /api/workers/{id}`

## Path parameters

- `id` string, required

## Request body

- UpdateWorkerRequest
  - `name` string — Name of the worker
  - `description` string — Description of the worker

## Response `200`

Updated worker

- Workers
  - `id` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `name` string, required
  - `description` string, nullable
  - `status` string, nullable
  - `lastRefreshedAt` string, date-time, nullable
  - `teamId` string, required
  - `flowsIds` string[]
  - `deploymentsIds` string[]
  - `resourcesIds` string[]
  - `integrationsIds` string[]

## Other responses

- `400` — Invalid request body
- `401` — Unauthorized
- `404` — Worker not found

## Changes

- **2025-02-04** `ab4ce60666d2` — 5 breaking, 4 info
  - removed the required property `deployments` from the response with the `200` status
  - removed the required property `flows` from the response with the `200` status
  - removed the required property `integrations` from the response with the `200` status
  - removed the required property `resources` from the response with the `200` status
  - …5 more
- **2025-02-04** `78ff4a594abd` — 6 breaking, 47 info
  - the request's body type/format changed from ``/`` to `object`/``
  - the `deployments` response's property type/format changed from `deployments`/`` to `object`/`` for status `200`
  - the `flows` response's property type/format changed from `flows`/`` to `object`/`` for status `200`
  - the `integrations` response's property type/format changed from `integrations`/`` to `object`/`` for status `200`
  - …49 more
- **2025-02-04** `a3da5c68a303` — 1 breaking, 3 warning, 1 info
  - the request's body type/format changed from `object`/`` to ``/``
  - removed the request property `description`
  - removed the request property `name`
  - removed the request property `status`
  - …1 more

[Change history](https://skmtc.dev/brainbasehq/apis/brainbase-api/changes/api/workers/:id/post.md)

---

[API](https://skmtc.dev/brainbasehq/apis/brainbase-api.md) · [All operations](https://skmtc.dev/brainbasehq/apis/brainbase-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brainbasehq/brainbase-api/revisions/ab4ce60666d2/schema)