Create a label for an organization

POST

/orgs/{org}/labels

const url = 'https://gitea.example.com/api/v1/orgs/example/labels';
const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <credentials>', 'Content-Type': 'application/json'},
  body: '{"color":"#00aabb","description":"example","exclusive":false,"is_archived":false,"name":"example"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://gitea.example.com/api/v1/orgs/example/labels \
  --header 'Authorization: Basic <credentials>' \
  --header 'Content-Type: application/json' \
  --data '{ "color": "#00aabb", "description": "example", "exclusive": false, "is_archived": false, "name": "example" }'

Authorizations

Parameters

Path Parameters

org

required

string

Name of the organization

Request Body

application/json

CreateLabelOption options for creating a label

object

color

required

string

Example

#00aabb

description

Description provides additional context about the label’s purpose

string

exclusive

boolean

Example

false

is_archived

boolean

Example

false

name

required

string

Responses

201

Label

application/json

Label a label to an issue or a pr

object

color

string

description

Description provides additional context about the label’s purpose

string

exclusive

boolean

ID is the unique identifier for the label

integer format: int64

is_archived

boolean

name

Name is the display name of the label

string

url

URL is the API endpoint for accessing this label

string

Example

{
  "color": "00aabb",
  "exclusive": false,
  "is_archived": false
}

404

APINotFound is a not found empty response

application/json

422

APIValidationError is error format response related to input validation

application/json

Headers

message

string

url

string