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
401 Unauthenticated
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
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