Skip to content

Get enterprise Issue statuses

GET /api/v5/enterprises/{enterprise}/issue/statuses

This endpoint retrieves the list of Issue statuses of the specified enterprise. By passing the enterprise namespace address path, you can query all Issue status information under the enterprise, including status names and status descriptions, making it easy to understand the various Issue statuses and their specific meanings.

Access token support

  • AtomGit user access token (AtomGit user access tokens)

Anonymous access

This endpoint allows anonymous access.

Request parameters

Parameter Location Type Required Description
enterprise path string Yes Address path of the namespace that owns the repository (the address path of an enterprise, organization, or individual)

Response parameters

The response is an array of Issue status objects. Each element contains the following fields:

Field Type Always returned Nullable Description
name string Yes No Status name
desc string Yes No Status description

Error responses

400 Invalid parameters

{
  "error": "invalid_request",
  "message": "Invalid parameters"
}

401 Unauthenticated

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

Note: Error field names are subject to the actual backend response.

HTTP status codes

Status code Description
200 Success (OK)
400 Bad request (Bad Request)
401 Requires authentication (Requires authentication)
404 Resource not found (Not Found)
500 Internal server error (Internal Server Error)

Request example

Parameter notes

Replace <enterprise> with the enterprise path (the address path of an enterprise, organization, or individual); this endpoint allows anonymous access and can also carry a user access token.

cURL

curl -X GET 'https://api.atomgit.com/api/v5/enterprises/<enterprise>/issue/statuses' \
  -H 'Accept: application/json'

JavaScript

// Native fetch (Node.js 18+ / browser)
const response = await fetch("https://api.atomgit.com/api/v5/enterprises/<enterprise>/issue/statuses", {
  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>/issue/statuses",
    headers={
        "Accept": "application/json",
    },
    timeout=10,
)
resp.raise_for_status()

print(resp.json())

Response example

Status code: 200

[
  {
    "name": "string",
    "desc": "string"
  }
]

Error codes

Error code Description
400 Invalid parameters or unparsable request
401 Unauthenticated or invalid credentials (missing or invalid access credential)
404 Request path does not exist
500 Internal server error

Markdown source: View on AtomGit·Content from the open-source project gitcode-dev/atomgit-api-doc