Skip to Content
SeyloDocs

List backup runs

GET
/api/v1/backups.listRuns

Lists a service's backup and restore runs, newest first, 50 per page. Pass the last run's startedAt as before for the next page.

Needs backups.view on the service (a grant on its project covers it). Available to MCP clients and the assistant.

Authorization

cookieseylo_session<token>

Query Parameters

serviceId*string

Panel-issued id.

Match^[a-z0-9]{16}$
policyId?string

Panel-issued id.

Match^[a-z0-9]{16}$
before?string
Formatdate-time
limit?integer
Range1 <= value <= 200

Response Body

Success.

application/json
  1. response
runs*array<>
hasMore*boolean
Example Request
curl -X GET 'https://example.com/api/v1/backups.listRuns?serviceId=string'
Example Response
{  "runs": [    {      "id": "string",      "kind": "backup",      "serviceId": "string",      "policyId": "string",      "destinationId": "string",      "target": "database",      "volumeId": "string",      "sourceRunId": "string",      "status": "running",      "objectKey": "string",      "sizeBytes": 0,      "error": "string",      "deletedAt": "2019-08-24T14:15:22Z",      "startedAt": "2019-08-24T14:15:22Z",      "finishedAt": "2019-08-24T14:15:22Z"    }  ],  "hasMore": true}