---
title: "Create a workflow"
method: POST
path: "/workflow"
tags: ["Workflow"]
---

# Create a workflow

`POST /workflow`

Create a new workflow

## Request body

- WorkflowCreateParams — From T, pick a set of properties whose keys are in the union K
  - `name` string, required — The name of the workflow
  - `color` string, required — The color of the workflow in a hex format
  - `projectId` integer, required — ID is a generic type that is used to represent a unique identifier

## Response `201`

Created

- Workflow — A user configurable status for Feedback with related models
  - `id` integer, required — ID is a generic type that is used to represent a unique identifier
  - `name` string, required — The name of the workflow
  - `sort` number, double, required — The order is which workflows are displayed
  - `color` string, required — The color of the workflow in a hex format
  - `Project` BaseProject, required — The base type for a Project. Used in list responses.
    - `id` integer, required — ID is a generic type that is used to represent a unique identifier
    - `name` string, required — Project name
    - `url` string, uri — Project url
    - `logo` string, uri — Logo url
    - `isArchived` boolean, required — If true, the project has been archived An archived project is not accessible in Userback and will eventually be deleted
    - `created` string, date-time, required — The date and time when the project was created in RFC 3339 format
    - `createdBy` integer, required — ID is a generic type that is used to represent a unique identifier

## Other responses

- `401` — Not Authorized
- `422` — Validation Error
- `429` — Too Many Requests
- `500` — Interal Server Error

---

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