API reference
CAIN Planner API
19 operations under /fabric/plans
Last reviewed 2026-10-03
Base URL https://cainstudio.online. Every call carries your key in the X-API-Key header; a free key comes from sign-up, and agent keys from the console. A key only ever sees its own tenant. A call the platform cannot decide is refused, never allowed: timeouts, outages and unknown verdicts do not become ALLOW.
| Method | Path | What it does |
|---|---|---|
| GET | /fabric/plans | List Plans |
| POST | /fabric/plans | Create Plan |
| POST | /fabric/plans/candidates | Generate Candidates |
| POST | /fabric/plans/generate | Generate Plan |
| GET | /fabric/plans/stats | Get Planner Stats |
| GET | /fabric/plans/{plan_id} | Get Plan |
| POST | /fabric/plans/{plan_id}/approve | Approve Plan |
| POST | /fabric/plans/{plan_id}/cancel | Cancel Plan |
| POST | /fabric/plans/{plan_id}/compare | Compare Plan |
| GET | /fabric/plans/{plan_id}/evidence | Get Plan Evidence |
| POST | /fabric/plans/{plan_id}/execute | Execute Plan |
| GET | /fabric/plans/{plan_id}/provenance | Get Plan Provenance |
| POST | /fabric/plans/{plan_id}/reject | Reject Plan |
| POST | /fabric/plans/{plan_id}/replan | Replan |
| POST | /fabric/plans/{plan_id}/revalidate | Revalidate Plan |
| GET | /fabric/plans/{plan_id}/trajectory | Get Plan Trajectory |
| POST | /fabric/plans/{plan_id}/validate | Validate Plan |
| POST | /fabric/plans/{plan_id}/verify | Verify Plan |
| GET | /fabric/plans/{plan_id}/versions | Get Plan Versions |
Products built on these calls
- CAIN Plans — Checks an agent's plan before it starts, then holds it to that plan.
Try CAIN-42 on your own agents
Create a free account and every new account starts with a 7-day trial of the full platform. Or try the sandbox first, with no account at all.
Create a free account → · Try the sandbox · See the whole ecosystem