Saltar al contenido principal
GET
Listar jobs de snapshot
Un snapshot o una restauración puede tardar más que una petición. Cada uno es un job que puedes seguir: un snapshot manual que no termina en 90 segundos responde 202 con un job_id, y una restauración responde siempre 202 con uno. Esta ruta lista los jobs de un recurso; Obtener job de snapshot lee uno solo.
string
requerido
El ID de la aplicación o de la base de datos.
string
requerido
El tipo de recurso. Valores posibles: applications, databases.
string
Si el recurso pertenece a un workspace, el ID del workspace.
string
Solo jobs de este tipo: snapshot o restore. Por defecto: ambos.
number
Número máximo de jobs, de 1 a 50. Por defecto 10. Un valor fuera de ese rango responde 400 VALIDATION_ERROR.

Respuesta

array
Los jobs, del más reciente al más antiguo.
Los jobs de un recurso que se borró se siguen devolviendo a la cuenta que lo poseía. Para un recurso que no existe, la lista vuelve vacía. 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).
  • VALIDATION_ERROR: limit no es un número de 1 a 50, o scope o kind tienen un valor que no existe (400).
  • INTERNAL_SERVER_ERROR: Ocurrió un error inesperado del servidor.
Última modificación el 20 de noviembre de 2026