Saltar al contenido principal
GET
Obtener job de snapshot
Usa esta ruta para seguir una restauración (response.job_id) o un snapshot manual que respondió 202 (response.job_id). Consúltala cada pocos segundos hasta que el status sea ready, skipped o failed. La forma del job es la descrita en Listar jobs de snapshot.
string
requerido
El ID de la aplicación o de la base de datos a la que pertenece el job. En una restauración, es el recurso que se está restaurando.
string
requerido
El ID del job.
string
Opcional. El tipo de recurso: applications o databases.
string
Si el recurso pertenece a un workspace, el ID del workspace.

Respuesta

object
El job: id, kind, resource_id, origin (solo en los jobs de snapshot), status, reason (cuando está failed o skipped), details (los detalles de ese error, cuando los hay), snapshot_id (el snapshot que produjo un job snapshot, siempre presente cuando está ready; en un job restore, el snapshot que se está restaurando), created_at, started_at, finished_at y, mientras está running, progress.
object
Solo mientras el job está running, y puede faltar (por ejemplo justo al empezar, o cuando no se conoce el progreso). No se envía en ningún otro estado.
Esta ruta admite 120 peticiones por minuto.

Respuestas de error

string
El código de error que indica el motivo del fallo. Valores posibles:
  • AUTH_TOKEN_MISSING, API_KEY_INVALID, SESSION_REVOKED: Falta la cabecera Authorization, la clave de API no es válida o la sesión del panel fue revocada (401).
  • API_KEY_IP_DENIED, API_KEY_SCOPE_DENIED: La clave de API se usa desde una IP fuera de su lista de permitidas, o no tiene el scope snapshots:read (403).
  • ACCESS_DENIED: Eres miembro de un workspace sin el permiso para esta acción, o no enviaste el workspace_id (403).
  • SNAPSHOT_NOT_FOUND: No se encontró (404).
  • INTERNAL_SERVER_ERROR: Ocurrió un error inesperado del servidor.
Última modificación el 20 de noviembre de 2026