---
title: "Create a label"
method: POST
path: "/labels"
tags: ["Labels"]
---

# Create a label

`POST /labels`

Create a new label in the workspace

## Request body

- CreateLabelInput
  - `name` string, required
  - `color` 'yellow' | 'purple' | 'orange' | 'red' | 'brown' | 'green', required

## Response `200`

Label created

- Label
  - `id` string, uuid
  - `name` string
  - `color` string — Hex color code
  - `backgroundColor` string — Hex background color code
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Missing or invalid API key
- `409` — Conflict - Resource already exists

---

[API](https://skmtc.net/tryordinal/apis/ordinal-api.md) · [All operations](https://skmtc.net/tryordinal/apis/ordinal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryordinal/ordinal-api/revisions/1d0792ff454f/schema)