Public API Surface
This page renders the published Runtime API route artifact as a readable endpoint index without replacing the authored route guides.
Scope: Runtime API only
The artifact below covers the Runtime API — project-API-key authenticated routes that Keel commits to as a stable customer integration contract (execution, permits, lifecycle, governance reads, compliance exports, and the public status summary). The SDKs wrap this surface.
The Management API — user-JWT authenticated dashboard routes for project, policy, provider-key, and billing management — is not in this artifact. Those routes back the Keel dashboard UI; their shape may evolve alongside dashboard redesigns, so they are documented on Platform Surfaces (with per-route guarantees on Route Guarantees) rather than versioned as a stable integration contract. If you need to automate dashboard workflows, you can call them with a user JWT — just pin the changelog and expect more churn than the Runtime API.
Use this page to answer four questions quickly:
- which Runtime API routes are currently exposed
- which family each route belongs to
- whether the route is labeled
canonical,official, oradjacent - what authentication surface the route expects
Treat the authored pages for Permits, Executions, Execute, Proxy Execution, Idempotency, and Errors as the source for integration behavior and examples.
Generated from public-routes.json. This snapshot is additive and does not replace the authored route guides elsewhere in the docs.
37 public routes found.
| Method | Path | Family | Summary |
|---|---|---|---|
| GET | /v1/compliance/exports | lifecycle | List compliance exports |
| POST | /v1/compliance/exports | lifecycle | Create compliance export |
| GET | /v1/compliance/exports/{export_id} | lifecycle | Get compliance export |
| POST | /v1/execute | execution | Execute provider request |
| POST | /v1/executions | execution | Create execution |
| GET | /v1/executions/{request_id} | execution | Get execution timeline |
| GET | /v1/governance/events | lifecycle | List governance events |
| GET | /v1/governance/events/{event_id} | lifecycle | Get governance event |
| GET | /v1/governance/events/stream | lifecycle | Stream governance events |
| POST | /v1/jobs | lifecycle | Submit async job |
| GET | /v1/jobs/{job_id} | lifecycle | Get async job |
| GET | /v1/metrics/executions | lifecycle | Get execution metrics |
| GET | /v1/permits | decision | List permits |
| POST | /v1/permits | decision | Create permit |
| GET | /v1/permits/{permit_id} | decision | Get permit |
| POST | /v1/permits/{permit_id}/attest | decision | Sign off challenged permit |
| GET | /v1/permits/{permit_id}/bundle | decision | Get permit audit report |
| GET | /v1/permits/{permit_id}/evidence | decision | List permit evidence |
| POST | /v1/permits/{permit_id}/evidence | decision | Attach permit evidence |
| GET | /v1/permits/{permit_id}/lineage | decision | Get permit lineage |
| POST | /v1/permits/{permit_id}/usage | decision | Report permit usage |
| POST | /v1/permits/dry-run | decision | Preview permit |
| GET | /v1/permits/export | decision | Export permits |
| POST | /v1/proxy/anthropic | execution | Proxy to Anthropic |
| POST | /v1/proxy/google | execution | Proxy to Google |
| POST | /v1/proxy/meta | execution | Proxy to Meta |
| POST | /v1/proxy/openai | execution | Proxy to OpenAI |
| POST | /v1/proxy/xai | execution | Proxy to xAI |
| GET | /v1/public/status/summary | status | Get public status summary |
| GET | /v1/requests/{request_id}/timeline | lifecycle | Get request timeline |
| GET | /v1/webhooks | lifecycle | List webhooks |
| POST | /v1/webhooks | lifecycle | Create webhook |
| DELETE | /v1/webhooks/{subscription_id} | lifecycle | Delete webhook |
| GET | /v1/webhooks/{subscription_id} | lifecycle | Get webhook |
| PATCH | /v1/webhooks/{subscription_id} | lifecycle | Update webhook |
| GET | /v1/webhooks/{subscription_id}/deliveries | lifecycle | List webhook deliveries |
| POST | /v1/webhooks/{subscription_id}/test | lifecycle | Test webhook |