# Obtener el estado de la implementación (/es/api/update/status)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 1394 · updated: 2026-07-30 -->
Related: [Iniciar implementación](/es/api/update/trigger.md), [Introducción a la API REST de Mintlify](/es/api/introduction.md)



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

Obtén el estado de una actualización mediante el ID de estado

Autentícate con una clave de API de administrador.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "name": "statusId",
      "in": "path",
      "description": "El identificador de estado de una actualización activada.",
      "required": true,
      "schema": {
        "type": "string"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Una respuesta correcta",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "_id": {
                "type": "string",
                "description": "El ID de estado de la actualización que se activó."
              },
              "projectId": {
                "type": "string",
                "description": "El identificador del proyecto de documentación."
              },
              "createdAt": {
                "type": "string",
                "description": "Un ISODate con la fecha y la hora especificadas en UTC"
              },
              "endedAt": {
                "type": "string",
                "description": "Un ISODate con la fecha y hora especificadas en UTC"
              },
              "status": {
                "type": "string",
                "enum": [
                  "queued",
                  "in_progress",
                  "success",
                  "failure"
                ],
                "description": "El estado de la actualización."
              },
              "summary": {
                "type": "string",
                "description": "Resumen del estado de la actualización"
              },
              "logs": {
                "type": "array",
                "description": "Una matriz de registros.",
                "items": {
                  "type": "string"
                }
              },
              "subdomain": {
                "type": "string",
                "description": "El subdominio de la documentación que se está actualizando."
              },
              "screenshot": {
                "type": "string",
                "description": "Una captura de pantalla de la documentación."
              },
              "screenshotLight": {
                "type": "string",
                "description": "Una captura de pantalla de la documentación."
              },
              "screenshotDark": {
                "type": "string",
                "description": "Captura de pantalla de la documentación en modo oscuro."
              },
              "author": {
                "type": "object",
                "description": "El autor de la actualización.",
                "nullable": true,
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "El nombre del autor."
                  },
                  "avatarUrl": {
                    "type": "string",
                    "description": "URL de la imagen de avatar del autor."
                  },
                  "githubUserId": {
                    "type": "number",
                    "description": "El identificador de usuario de GitHub del autor."
                  }
                }
              },
              "commit": {
                "type": "object",
                "description": "Detalles de la confirmación",
                "properties": {
                  "sha": {
                    "type": "string",
                    "description": "El SHA de la confirmación."
                  },
                  "ref": {
                    "type": "string",
                    "description": "La referencia de la confirmación."
                  },
                  "message": {
                    "type": "string",
                    "description": "El mensaje de confirmación."
                  },
                  "filesChanged": {
                    "type": "object",
                    "description": "Detalles de los archivos modificados.",
                    "properties": {
                      "added": {
                        "type": "array",
                        "description": "Se han añadido nuevos archivos.",
                        "items": {
                          "type": "string"
                        }
                      },
                      "modified": {
                        "type": "array",
                        "description": "Archivos existentes que fueron modificados.",
                        "items": {
                          "type": "string"
                        }
                      },
                      "removed": {
                        "type": "array",
                        "description": "Archivos eliminados.",
                        "items": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              },
              "source": {
                "type": "string",
                "description": "Origen del disparador de la actualización.",
                "enum": [
                  "internal",
                  "github-app-installation",
                  "api",
                  "github",
                  "dashboard",
                  "gitlab",
                  "onboarding"
                ]
              }
            }
          }
        }
      }
    }
  }
}
```