---
title: "Create a new worker"
method: POST
path: "/api/workers"
tags: ["Workers"]
---

# Create a new worker

`POST /api/workers`

## Request body

- CreateWorkerRequest
  - `name` string, required — Name of the worker
  - `description` string — Description of the worker

## Response `201`

Worker created

- 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

## Changes

- **2025-02-04** `ab4ce60666d2` — 5 breaking, 4 info
  - removed the required property `deployments` from the response with the `201` status
  - removed the required property `flows` from the response with the `201` status
  - removed the required property `integrations` from the response with the `201` status
  - removed the required property `resources` from the response with the `201` status
  - …5 more
- **2025-02-04** `78ff4a594abd` — 7 breaking, 46 info
  - added the new required request property `name`
  - the request's body type/format changed from ``/`` to `object`/``
  - the `deployments` response's property type/format changed from `deployments`/`` to `object`/`` for status `201`
  - the `flows` response's property type/format changed from `flows`/`` to `object`/`` for status `201`
  - …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/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)