Skip to Content
SeyloDocs
API referenceApprovals

List approvals

GET
/api/v1/approvals.list

Lists approvals newest first: pending ones by default, or every status. Owners and admins see all; others see the ones their own tokens and assistant chats asked for.

Any signed-in caller. Available to MCP clients and the assistant.

Authorization

cookieseylo_session<token>

Query Parameters

status?string|string|string|string|string|string|string
limit?integer
Range1 <= value <= 200
Default50
cursor?string
Lengthlength <= 64

Response Body

Success.

application/json
  1. response
approvals*array<>
nextCursor*string|null
pendingCount*integer
Range0 <= value
Example Request
curl -X GET 'https://example.com/api/v1/approvals.list'
Example Response
{  "approvals": [    {      "id": "string",      "opId": "string",      "opSummary": "string",      "opKind": "mutation",      "inputPreview": null,      "via": "mcp",      "requestedBy": {        "userId": "string",        "userName": "string",        "clientName": "string"      },      "reason": "string",      "target": {        "type": "project",        "id": "string",        "name": "string"      },      "status": "pending",      "decidedBy": {        "id": "string",        "name": "string"      },      "decidedAt": "2019-08-24T14:15:22Z",      "error": "string",      "expiresAt": "2019-08-24T14:15:22Z",      "createdAt": "2019-08-24T14:15:22Z"    }  ],  "nextCursor": "string",  "pendingCount": 0}

Get an approval GET

Returns one approval. Models use it to see whether the action they asked for was approved, denied or has run. Any signed-in caller. Available to MCP clients and the assistant.

Add a backup destination POST

Adds an S3-compatible bucket (AWS S3, Cloudflare R2, MinIO) for backups. Run backups.testDestination first to check the keys. Needs `backups.destinations`, which owners and admins hold. Not available to MCP clients or the assistant.