Skip to main content
GET
List Snapshot Jobs
A snapshot or a restore can take longer than a request. Each one is a job you can follow: a manual snapshot that does not finish in 90 seconds answers 202 with a job_id, and a restore always answers 202 with one. This route lists the jobs of one resource; Get Snapshot Job reads a single job.
string
required
The ID of the application or database.
string
required
The resource type. Possible values: applications, databases.
string
If the resource belongs to a workspace, the workspace’s ID.
string
Only jobs of this kind: snapshot or restore. Default: both.
number
Maximum number of jobs, from 1 to 50. Default 10. A value outside that range answers 400 VALIDATION_ERROR.

Response

array
The jobs, most recent first.
Jobs of a resource that was deleted are still returned to the account that owned it. For a resource that does not exist, the list comes back empty. This route allows 120 requests per minute.

Error Responses

string
The error code indicating the reason for failure. Possible values:
  • AUTH_TOKEN_MISSING, API_KEY_INVALID, SESSION_REVOKED: The Authorization header is missing, the API key is invalid, or the dashboard session was revoked (401).
  • API_KEY_IP_DENIED, API_KEY_SCOPE_DENIED: The API key is used from an IP outside its allowlist, or it lacks the snapshots:read scope (403).
  • ACCESS_DENIED: You are a workspace member without the permission for this action, or you did not send the workspace_id (403).
  • VALIDATION_ERROR: limit is not a number from 1 to 50, or scope or kind has a value that does not exist (400).
  • INTERNAL_SERVER_ERROR: An unexpected server error occurred.
Last modified on November 20, 2026