Skip to Content
SeyloDocs
API referenceApprovals

Get an approval

GET
/api/v1/approvals.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.

Authorization

cookieseylo_session<token>

Query Parameters

approvalId*string

Panel-issued id.

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

Response Body

Success.

application/json
  1. response
id*string

Panel-issued id.

Match^[a-z0-9]{16}$
opId*string
opSummary*string
opKind*string|string
inputPreview*unknown
via*string|string
requestedBy*
reason*string
target*|null
status*string|string|string|string|string|string
decidedBy*|null
decidedAt*|null
error*string|null
expiresAt*string
Formatdate-time
createdAt*string
Formatdate-time
Example Request
curl -X GET 'https://example.com/api/v1/approvals.get?approvalId=string'
Example Response
{  "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"}

Deny an action POST

Rejects a pending approval; the model is told it was denied, with the note when given. Any signed-in caller. Not available to MCP clients or the assistant.

List approvals GET

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.