---
title: "Add a label to an issue"
method: POST
path: "/repos/{owner}/{repo}/issues/{index}/labels"
tags: ["issue"]
---

# Add a label to an issue

`POST /repos/{owner}/{repo}/issues/{index}/labels`

## Path parameters

- `owner` string, required
- `repo` string, required
- `index` integer, required

## Request body

- IssueLabelsOption — IssueLabelsOption a collection of labels
  - `labels` unknown[] — Labels can be a list of integers representing label IDs or a list of strings representing label names
    - unknown

## Response `200`

LabelList

- Label[]
  - `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

- `403` — APIForbiddenError is a forbidden error response
- `404` — APINotFound is a not found empty response

---

[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/versions/350de506cefa/schema)