Skip to main content
POST
Check a proposed action before committing it

Authorizations

Authorization
string
header
required

Send Authorization: Bearer YOUR_API_KEY. The key resolves to a single organization.

Body

application/json
agentId
string<uuid>
required
referenceData
object
required
comparisons
object[]
required
Required array length: 1 - 20 elements
tools
object[]

Tool keys must be unique and distinct from comparison keys. Keys are case-sensitive and trimmed. Send one authoritative status per execution prerequisite.

Maximum array length: 20
requiredTools
string[]

Caller-owned prerequisite tool keys, independent of reported executions. Every listed tool must be reported as succeeded. Omitted required tools produce missing and block approval. Use only pre-action prerequisites, not the action being authorized. Defaults to an empty list for compatibility.

Maximum array length: 20
Required string length: 1 - 80

Response

Decision for the supplied snapshot

decision
enum<string>
required
Available options:
proceed,
request_clarification,
flag_mismatch
allowed
boolean
required
checks
object[]
required