# Obtenir le statut de déploiement (/fr/api/update/status)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 1381 · updated: 2026-07-30 -->
Related: [Déclencher un déploiement](/fr/api/update/trigger.md), [Introduction à l'API REST Mintlify](/fr/api/introduction.md)



`GET /project/update-status/{statusId}`

Récupérer le statut d’une mise à jour à partir de son identifiant de statut

Authentifiez-vous avec une clé d'API administrateur.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "name": "statusId",
      "in": "path",
      "description": "L’identifiant de statut de la mise à jour déclenchée.",
      "required": true,
      "schema": {
        "type": "string"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Une réponse réussie",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "_id": {
                "type": "string",
                "description": "L’identifiant de statut de la mise à jour déclenchée."
              },
              "projectId": {
                "type": "string",
                "description": "L’identifiant du projet de documentation."
              },
              "createdAt": {
                "type": "string",
                "description": "Une valeur ISODate correspondant à la date et à l’heure spécifiées en UTC"
              },
              "endedAt": {
                "type": "string",
                "description": "Une valeur ISODate correspondant à la date et à l’heure spécifiées en UTC"
              },
              "status": {
                "type": "string",
                "enum": [
                  "queued",
                  "in_progress",
                  "success",
                  "failure"
                ],
                "description": "Le statut de la mise à jour."
              },
              "summary": {
                "type": "string",
                "description": "Récapitulatif de l’état de la mise à jour"
              },
              "logs": {
                "type": "array",
                "description": "Un tableau de logs.",
                "items": {
                  "type": "string"
                }
              },
              "subdomain": {
                "type": "string",
                "description": "Le sous-domaine de la documentation en cours de mise à jour."
              },
              "screenshot": {
                "type": "string",
                "description": "Une capture d’écran de la documentation."
              },
              "screenshotLight": {
                "type": "string",
                "description": "Une capture d’écran de la doc."
              },
              "screenshotDark": {
                "type": "string",
                "description": "Une capture d’écran de la documentation en mode sombre."
              },
              "author": {
                "type": "object",
                "description": "L'auteur de la mise à jour.",
                "nullable": true,
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Le nom de l'auteur."
                  },
                  "avatarUrl": {
                    "type": "string",
                    "description": "URL de l'avatar de l'auteur."
                  },
                  "githubUserId": {
                    "type": "number",
                    "description": "L'identifiant GitHub de l'auteur."
                  }
                }
              },
              "commit": {
                "type": "object",
                "description": "Les détails du commit",
                "properties": {
                  "sha": {
                    "type": "string",
                    "description": "Le SHA du commit."
                  },
                  "ref": {
                    "type": "string",
                    "description": "La référence du commit."
                  },
                  "message": {
                    "type": "string",
                    "description": "Le message de commit."
                  },
                  "filesChanged": {
                    "type": "object",
                    "description": "Détails des fichiers modifiés.",
                    "properties": {
                      "added": {
                        "type": "array",
                        "description": "De nouveaux fichiers ont été ajoutés.",
                        "items": {
                          "type": "string"
                        }
                      },
                      "modified": {
                        "type": "array",
                        "description": "Fichiers existants modifiés.",
                        "items": {
                          "type": "string"
                        }
                      },
                      "removed": {
                        "type": "array",
                        "description": "Fichiers supprimés.",
                        "items": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              },
              "source": {
                "type": "string",
                "description": "La source du déclencheur de mise à jour.",
                "enum": [
                  "internal",
                  "github-app-installation",
                  "api",
                  "github",
                  "dashboard",
                  "gitlab",
                  "onboarding"
                ]
              }
            }
          }
        }
      }
    }
  }
}
```