---
title: "Create issue label"
method: POST
path: "/api/v1/issue-labels"
tags: ["issues"]
---

# Create issue label

`POST /api/v1/issue-labels`

## Request

- Base URL: `https://api.capy.ai`
- URL: `https://api.capy.ai/api/v1/issue-labels`
- Auth: HTTP bearer

## Request body

- CreateIssueLabelRequest
  - `name` string, required
  - `color` 'gray' | 'blue' | 'purple' | 'pink' | 'red' | 'orange' | 'yellow' | 'lime' | 'green', required

## Response `200`

IssueLabel

- IssueLabelEncoded
  - `id` string, required
  - `name` string, required
  - `color` union, required
    - 'gray' | 'blue' | 'purple' | 'pink' | 'red' | 'orange' | 'yellow' | 'lime' | 'green'
    - string

## Other responses

- `400`: capy/InvalidRequest
- `401`: capy/Unauthorized
- `403`: capy/Forbidden
- `404`: capy/IssueNotFound
- `429`: capy/RateLimited

## Changes

- **2026-10-31** `e3be47264feb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/capy/apis/capy-api/changes/api/v1/issue-labels/post.md)

---

[API](https://skmtc.dev/capy/apis/capy-api.md) - [All operations](https://skmtc.dev/capy/apis/capy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/capy/apis/capy-api/revisions/4663f7dc4e39?raw)