Public API Surface
This page renders the published Runtime API route artifact as a readable endpoint index without replacing the authored route guides.
Scope: customer-facing API only
The artifact below covers the customer-facing API — public, project-API-key, or admin-scoped project-API-key routes that Keel treats as customer integration surfaces and that are eligible for public use. The SDKs wrap the main execution, permit, lifecycle, and readback routes.
The Management API — user-JWT authenticated dashboard routes for project, policy, provider-key, and billing management — is intentionally omitted from this projection. Those routes back the Keel dashboard UI and may evolve alongside dashboard redesigns.
Mounted action paths marked unreleased or ineligible for a public claim by the release registry are also omitted. See Surface Maturity for the distinction between route presence, enforcement, and release maturity.
Use this page to answer four questions quickly:
- which customer-facing routes are currently exposed
- which family each route belongs to
- whether the route is labeled
canonicalorofficial - what public auth class 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.
This projection includes canonical and official customer routes that are eligible for public use. Dashboard-management, adjacent compatibility, operator-only, and release-ineligible action paths are omitted; inclusion here is not a maturity claim.
62 public routes found.
| Method | Path | Family | Exposure | Auth | Summary |
|---|---|---|---|---|---|
| GET | /v1/authoring-context | decision | official | Project API key | Get Runtime-key authoring context |
| GET | /v1/compliance/exports | lifecycle | official | Project API key | List compliance exports |
| POST | /v1/compliance/exports | lifecycle | official | Project API key | Create compliance export |
| GET | /v1/compliance/exports/{export_id} | lifecycle | official | Project API key | Get compliance export |
| GET | /v1/compliance/keys | status | official | Public | List trust verification public keys |
| POST | /v1/execute | execution | official | Project API key | Execute provider request |
| POST | /v1/executions | execution | official | Project API key | Create execution |
| GET | /v1/executions/{request_id} | execution | official | Project API key | Get execution timeline |
| GET | /v1/governance/events | lifecycle | official | Project API key | List governance events |
| GET | /v1/governance/events/{event_id} | lifecycle | official | Project API key | Get governance event |
| GET | /v1/governance/events/stream | lifecycle | official | Project API key | Stream governance events |
| GET | /v1/integrity/checkpoint-public-key | status | official | Public | Get checkpoint signing public key |
| GET | /v1/integrity/permit-binding-public-keys | status | official | Public | List permit-binding public keys and active windows |
| POST | /v1/jobs | lifecycle | official | Project API key | Submit async job |
| GET | /v1/jobs/{job_id} | lifecycle | official | Project API key | Get async job |
| GET | /v1/mcp/decision-records/{decision_id} | decision | official | Project API key | Get bounded MCP decision record |
| GET | /v1/metrics/executions | lifecycle | official | Project API key | Get execution metrics |
| GET | /v1/permits | decision | official | Project API key | List permits |
| POST | /v1/permits | decision | canonical | Project API key | Create permit |
| GET | /v1/permits/{permit_id} | decision | official | Project API key | Get permit |
| GET | /v1/permits/{permit_id}/artifact | decision | official | Project API key | Get human Permit artifact |
| GET | /v1/permits/{permit_id}/artifact/download | decision | official | Project API key | Download Permit artifact |
| POST | /v1/permits/{permit_id}/attest | decision | official | Project API key | Sign off challenged permit |
| GET | /v1/permits/{permit_id}/bundle | decision | official | Project API key | Get permit audit report |
| POST | /v1/permits/{permit_id}/close | decision | official | Project API key with admin scope | End Work authority |
| GET | /v1/permits/{permit_id}/evidence | decision | official | Project API key | List permit evidence |
| POST | /v1/permits/{permit_id}/evidence | decision | official | Project API key | Attach permit evidence |
| GET | /v1/permits/{permit_id}/lineage | decision | official | Project API key | Get permit lineage |
| GET | /v1/permits/{permit_id}/mcp-tool-calls | decision | official | Project API key | List permit MCP tool-call evidence |
| GET | /v1/permits/{permit_id}/proof-pack | decision | official | Project API key | Download Permit decision proof |
| GET | /v1/permits/{permit_id}/receipt | decision | official | Project API key | Get permit receipt |
| POST | /v1/permits/{permit_id}/revoke | decision | official | Project API key with admin scope | Revoke permit |
| GET | /v1/permits/{permit_id}/timeline | lifecycle | official | Project API key | Get permit timeline |
| POST | /v1/permits/{permit_id}/usage | decision | official | Project API key with admin scope | Report permit usage |
| POST | /v1/permits/dry-run | decision | official | Project API key | Preview permit |
| GET | /v1/permits/export | decision | official | Project API key | Export permits |
| POST | /v1/proxy/anthropic | execution | official | Project API key | Proxy to Anthropic |
| POST | /v1/proxy/google | execution | official | Project API key | Proxy to Google |
| POST | /v1/proxy/meta | execution | official | Project API key | Proxy to Meta |
| POST | /v1/proxy/openai | execution | official | Project API key | Proxy to OpenAI |
| POST | /v1/proxy/xai | execution | official | Project API key | Proxy to xAI |
| GET | /v1/public/status/summary | status | official | Public | Get public status summary |
| GET | /v1/requests/{request_id}/timeline | lifecycle | official | Project API key | Get request timeline |
| POST | /v1/sessions | lifecycle | official | Project API key | Start realtime session |
| GET | /v1/sessions/{session_id} | lifecycle | official | Project API key | Get realtime session |
| POST | /v1/sessions/{session_id}/action-permits | decision | official | Project API key or approval key | Issue action permit |
| POST | /v1/sessions/{session_id}/end | lifecycle | official | Project API key | End realtime session |
| GET | /v1/sessions/{session_id}/events | lifecycle | official | Project API key | Stream realtime session events |
| POST | /v1/sessions/{session_id}/interruption-events | lifecycle | official | Project API key | Emit signed realtime interruption evidence |
| GET | /v1/sessions/{session_id}/mcp-tool-calls | lifecycle | official | Project API key | List session MCP tool-call evidence |
| POST | /v1/sessions/{session_id}/search-evidence | lifecycle | official | Project API key | Record search policy evidence |
| GET | /v1/sessions/{session_id}/search-evidence/{search_id} | lifecycle | official | Project API key | Get search policy evidence |
| POST | /v1/sessions/{session_id}/turns | lifecycle | official | Project API key | Submit realtime session turn |
| GET | /v1/verification-profile | decision | official | Project API key | Get Runtime-key verification profile |
| POST | /v1/voice/sessions/{session_id}/events | lifecycle | official | Project API key | Ingest batched voice session events |
| GET | /v1/webhooks | lifecycle | official | Project API key | List webhooks |
| POST | /v1/webhooks | lifecycle | official | Project API key | Create webhook |
| DELETE | /v1/webhooks/{subscription_id} | lifecycle | official | Project API key | Delete webhook |
| GET | /v1/webhooks/{subscription_id} | lifecycle | official | Project API key | Get webhook |
| PATCH | /v1/webhooks/{subscription_id} | lifecycle | official | Project API key | Update webhook |
| GET | /v1/webhooks/{subscription_id}/deliveries | lifecycle | official | Project API key | List webhook deliveries |
| POST | /v1/webhooks/{subscription_id}/test | lifecycle | official | Project API key | Test webhook |