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. 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.
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.
Dashboard management routes and implementation-level auth handlers are omitted from this projection.
49 public routes found.
| Method | Path | Family | Exposure | Auth | Summary |
|---|---|---|---|---|---|
| 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/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 |
| 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 |
| 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 |
| POST | /v1/permits/{permit_id}/revoke | decision | official | Project API key with admin scope | Revoke permit |
| 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/{session_id}/google-gemini-tool-runs | execution | official | Project API key | Dispatch governed Google Gemini tool run |
| GET | /v1/sessions/{session_id}/google-gemini-tool-runs/{run_id} | lifecycle | official | Project API key | Get Google Gemini tool-run signed 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}/openai-responses-tool-runs | execution | official | Project API key | Dispatch governed OpenAI Responses tool run |
| GET | /v1/sessions/{session_id}/openai-responses-tool-runs/{run_id} | lifecycle | official | Project API key | Get OpenAI Responses tool-run signed 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 |
| 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 |