Get all labels of an enterprise issue¶

GET /api/v5/enterprises/{enterprise}/issues/{number}/labels

Retrieves all labels of the specified issue in an enterprise, returning each label's number, name, color, and link information; supports pagination.

Access token support¶

• AtomGit user access token (AtomGit user access tokens)

Anonymous access¶

This endpoint does not allow anonymous access.

Request parameters¶

Response parameters¶

The endpoint returns an array of label objects, each structured as follows:

Error responses¶

A 200/success response is not enough: callers need to know what a failure looks like to write error handling.

400 Parameter error

{
  "error": "invalid_request",
  "message": "Invalid number parameter"
}

401 Unauthenticated

{
  "error": "unauthorized",
  "message": "Missing or invalid access token"
}

404 Resource not found

{
  "error": "not_found",
  "message": "Enterprise or issue not found"
}

The actual error field names returned by the backend take precedence.

HTTP status codes¶

Request example¶

Parameter notes¶

The examples must be consistent with the rest of this document and can be copied and used directly to call successfully. Three hard requirements:

1. The authentication header must match "Access token support": if that section says a token is required, the examples must include access_token.
2. Do not omit any required parameter: path parameters and required query parameters must all appear in the examples.
3. Placeholders must be replaceable: use the <...> form consistently, and explain the meaning of each placeholder below.

Replace <enterprise> with the enterprise name (path); replace <number> with the globally unique issue number; replace <token> with your AtomGit user access token.

cURL¶

curl -X GET 'https://api.atomgit.com/api/v5/enterprises/<enterprise>/issues/<number>/labels?access_token=<token>&page=1&per_page=100' \
  -H 'Accept: application/json'

JavaScript¶

// Native fetch (Node.js 18+ / browsers)
const response = await fetch(
  "https://api.atomgit.com/api/v5/enterprises/<enterprise>/issues/<number>/labels?access_token=<token>&page=1&per_page=100",
  {
    headers: {
      "Accept": "application/json",
    },
  },
);

if (!response.ok) {
  throw new Error(`Request failed: ${response.status}`);
}

const data = await response.json();
console.log(data);

Python¶

import requests

resp = requests.get(
    "https://api.atomgit.com/api/v5/enterprises/<enterprise>/issues/<number>/labels",
    params={
        "access_token": "<token>",
        "page": 1,
        "per_page": 100,
    },
    headers={"Accept": "application/json"},
    timeout=10,
)
resp.raise_for_status()

print(resp.json())

Response example¶

Status code: 200

[
  {
    "id": 381445,
    "color": "#008672",
    "name": "help wanted",
    "url": ""
  }
]

Error codes¶