Endpoints
Six resources cover the loop from authority to evidence. Contract preview · not live
| Method | Path | What it does |
|---|---|---|
| POST | /v1/grants | Issue a purpose-bound, limited, expiring grant from a principal to an agent for one action. |
| GET | /v1/grants/:id | Read a grant's scope, status, and consumption state. |
| DEL | /v1/grants/:id | Revoke a grant before use. Revocation is itself a recorded event. |
| POST | /v1/targets/verify | Target-side check: is this grant valid, unexpired, and unreplayed for this exact action? |
| POST | /v1/receipts | Seal a receipt binding grant, execution, evidence, and observed outcome. |
| GET | /v1/receipts/:id | Fetch a sealed receipt for review, dispute, or audit. |
| POST | /v1/autonomy/review | Recompute an agent's grant scope from verified outcomes — wider after proof, narrower after misses. |
| GET | /v1/agents/:id/authority | The agent's current authority envelope: what it may do, under which limits, earned from what evidence. |