---
title: "Create a label for an organization"
method: POST
path: "/orgs/{org}/labels"
tags: ["organization"]
---

# Create a label for an organization

`POST /orgs/{org}/labels`

## Path parameters

- `org` string, required

## Request body

- CreateLabelOption — CreateLabelOption options for creating a label
  - `color` string, required
  - `description` string — Description provides additional context about the label's purpose
  - `exclusive` boolean
  - `is_archived` boolean
  - `name` string, required — Name is the display name for the new label

## Response `201`

Label

- Label — Label a label to an issue or a pr
  - `color` string
  - `description` string — Description provides additional context about the label's purpose
  - `exclusive` boolean
  - `id` integer — ID is the unique identifier for the label
  - `is_archived` boolean
  - `name` string — Name is the display name of the label
  - `url` string — URL is the API endpoint for accessing this label

## Other responses

- `404` — APINotFound is a not found empty response
- `422` — APIValidationError is error format response related to input validation

---

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