List backups

Returns retained project backups, newest scheduled first. Backups remain discoverable after their source branch is removed. Languages describe scheduled metadata until capture succeeds; created_at is scheduling time. Requires project-level settings management permission.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
^pr_[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Public id that is created from the type prefix of the corresponding resource and its UUID. I.e : For a project, a valid value would be : pr_0197c8f2-5a6b-7cde-8f12-3456789abcde

Query Params
filter
object

Filters and sorts the list: URL-encoded JSON of the schema BackupFilter. where holds exactly one _and or _or with an array of clauses; a clause is another _and/_or or a field with exactly one operator. sort lists fields with + (ascending) or - (descending). An unsupported field, operator or value answers 400 invalid_filter with a pointer into the filter.

FieldTypeOperatorsSort
backup[branch_id]id_eq _ne _in _nin–
backup[branch_name]text_eq _ne _like _nlike _ilike _nilike _contains _ncontains _icontains _nicontains _starts _ends _blank _nblankyes
backup[created_at]timestamp_eq _lt _gt _lte _gte _within _null _nnullyes
backup[id]id_eq _ne _in _nin–
backup[name]text_eq _ne _like _nlike _ilike _nilike _contains _ncontains _icontains _nicontains _starts _ends _blank _nblankyes
backup[status]QUEUED | PROCESSING | SUCCEEDED | PARTIALLY_SUCCEEDED | FAILED | CANCELLED | SKIPPED_eq _ne _in _nin–
backup[updated_at]timestamp_eq _lt _gt _lte _gte _within _null _nnullyes
string

Opaque pagination cursor from the next_cursor field of a previous response. Omit for the first page.

int32
1 to 100
Defaults to 20

Maximum number of items to return per page (1-100).

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json