Points de terminaison d’API REST pour les statuts de planification
Utilisez l’API REST pour répertorier les états de planification que les issues dans un dépôt peuvent avoir. Les états des problèmes se trouvent dans aperçu et disponibles uniquement pour les comptes inscrits dans la préversion.
List planning statuses for a repository
Lists the selectable planning statuses available.
Planning statuses are returned in deterministic display order:
Backlog, Todo, In progress, In review, Done, Not planned, and Duplicate.
Clients should expect new keys to be added.
Returns 404 Not Found when issue statuses aren't available in the repository.
Note
Issue statuses are in preview and subject to change. They're only available to accounts enrolled in the preview.
You need read access to the repository's issues to use this endpoint.
OAuth app tokens and personal access tokens (classic) need the repo scope
to use this endpoint with a private repository.
Fine-grained access tokens require the "Issues" repository permission (read).
Jetons d'accès granulaires pour «List planning statuses for a repository»
Ce point de terminaison fonctionne avec les types de tokens à granularité fine suivants:
- jetons d’accès utilisateur de l’application GitHub
- jetons d’accès d’installation de l’application GitHub
- Tokens d’accès personnel à granularité fine
Le token à granularité fine doit disposer de l’ensemble d’autorisations suivant:
- "Issues" repository permissions (read)
Ce point de terminaison peut être utilisé sans authentification ou sans les autorisations mentionnées ci-dessus si seules les ressources publiques sont demandées.
Paramètres pour «List planning statuses for a repository »
| Nom, Type, Description |
|---|
accept string Setting to |
| Nom, Type, Description |
|---|
owner string RequisThe account owner of the repository. The name is not case sensitive. |
repo string RequisThe name of the repository without the |
Codes d’état de réponse HTTP pour «List planning statuses for a repository »
| Code de statut | Description |
|---|---|
200 | Available planning statuses in display order |
404 | Resource not found |
Exemples de code pour «List planning statuses for a repository »
Si vous accédez à GitHub à GHE.com, remplacez api.github.com par le sous-domaine dédié de votre entreprise à api.SUBDOMAIN.ghe.com.
Exemple de requête
curl -L \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
-H "X-GitHub-Api-Version: 2026-03-10" \
https://api.github.com/repos/OWNER/REPO/planning-statusesAvailable planning statuses in display order
Status: 200[
{
"id": 2,
"name": "Backlog",
"category": "backlog"
},
{
"id": 3,
"name": "Todo",
"category": "planned"
},
{
"id": 4,
"name": "In progress",
"category": "started"
},
{
"id": 8,
"name": "In review",
"category": "started"
},
{
"id": 5,
"name": "Done",
"category": "completed"
},
{
"id": 6,
"name": "Not planned",
"category": "not_planned"
},
{
"id": 7,
"name": "Duplicate",
"category": "duplicate"
}
]