---
title: "Create a new flow"
method: POST
path: "/api/workers/{workerId}/flows"
tags: ["Flows"]
---

# Create a new flow

`POST /api/workers/{workerId}/flows`

## Path parameters

- `workerId` string, required

## Request body

- CreateFlowRequest — unresolved $ref

## Response `201`

Flow created

- Flows
  - `id` string, required
  - `version` integer, required
  - `name` string, required
  - `label` string, nullable
  - `code` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `worker` unknown, required
  - `workerId` string, required
  - `deployments` unknown, required

## Other responses

- `400` — Invalid request body
- `401` — Unauthorized

## Changes

- **2025-02-04** `a3da5c68a303` — 1 breaking, 3 warning, 1 info
  - the request's body type/format changed from `object`/`` to ``/``
  - removed the request property `code`
  - removed the request property `label`
  - removed the request property `name`
  - …1 more

[Change history](https://skmtc.dev/brainbasehq/apis/brainbase-api/changes/api/workers/:workerId/flows/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/a3da5c68a303/schema)