Pular para o conteúdo principal
GET
Listar jobs de snapshot
Um snapshot ou uma restauração pode demorar mais que uma requisição. Cada um é um job que você pode acompanhar: um snapshot manual que não termina em 90 segundos responde 202 com um job_id, e uma restauração sempre responde 202 com um. Esta rota lista os jobs de um recurso; Obter job de snapshot lê um job só.
string
obrigatório
O ID da aplicação ou do banco de dados.
string
obrigatório
O tipo do recurso. Valores possíveis: applications, databases.
string
Se o recurso pertence a um workspace, o ID do workspace.
string
Só jobs deste tipo: snapshot ou restore. Padrão: os dois.
number
Número máximo de jobs, de 1 a 50. Padrão 10. Um valor fora desse intervalo responde 400 VALIDATION_ERROR.

Resposta

array
Os jobs, do mais recente para o mais antigo.
Os jobs de um recurso que foi excluído continuam sendo devolvidos à conta que era dona dele. Para um recurso que não existe, a lista volta vazia. Esta rota permite 120 requisições por minuto.

Respostas de erro

string
O código de erro que indica o motivo da falha. Valores possíveis:
  • AUTH_TOKEN_MISSING, API_KEY_INVALID, SESSION_REVOKED: o header Authorization está ausente, a chave de API é inválida ou a sessão do painel foi revogada (401).
  • API_KEY_IP_DENIED, API_KEY_SCOPE_DENIED: a chave de API é usada a partir de um IP fora da sua allowlist, ou não tem o escopo snapshots:read (403).
  • ACCESS_DENIED: você é membro de um workspace sem a permissão para esta ação, ou não enviou o workspace_id (403).
  • VALIDATION_ERROR: limit não é um número de 1 a 50, ou scope ou kind tem um valor que não existe (400).
  • INTERNAL_SERVER_ERROR: ocorreu um erro inesperado no servidor.
Última modificação em 20 de novembro de 2026