Skip to Content
API ReferencePublic API Surface

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 canonical or official
  • 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.

Public API routes generated from the backend artifact.
MethodPathFamilyExposureAuthSummary
GET/v1/compliance/exportslifecycleofficialProject API key

List compliance exports

POST/v1/compliance/exportslifecycleofficialProject API key

Create compliance export

GET/v1/compliance/exports/{export_id}lifecycleofficialProject API key

Get compliance export

GET/v1/compliance/keysstatusofficialPublic

List trust verification public keys

POST/v1/executeexecutionofficialProject API key

Execute provider request

POST/v1/executionsexecutionofficialProject API key

Create execution

GET/v1/executions/{request_id}executionofficialProject API key

Get execution timeline

GET/v1/governance/eventslifecycleofficialProject API key

List governance events

GET/v1/governance/events/{event_id}lifecycleofficialProject API key

Get governance event

GET/v1/governance/events/streamlifecycleofficialProject API key

Stream governance events

GET/v1/integrity/checkpoint-public-keystatusofficialPublic

Get checkpoint signing public key

GET/v1/integrity/permit-binding-public-keysstatusofficialPublic

List permit-binding public keys and active windows

POST/v1/jobslifecycleofficialProject API key

Submit async job

GET/v1/jobs/{job_id}lifecycleofficialProject API key

Get async job

GET/v1/metrics/executionslifecycleofficialProject API key

Get execution metrics

GET/v1/permitsdecisionofficialProject API key

List permits

POST/v1/permitsdecisioncanonicalProject API key

Create permit

GET/v1/permits/{permit_id}decisionofficialProject API key

Get permit

POST/v1/permits/{permit_id}/attestdecisionofficialProject API key

Sign off challenged permit

GET/v1/permits/{permit_id}/bundledecisionofficialProject API key

Get permit audit report

GET/v1/permits/{permit_id}/evidencedecisionofficialProject API key

List permit evidence

POST/v1/permits/{permit_id}/evidencedecisionofficialProject API key

Attach permit evidence

GET/v1/permits/{permit_id}/lineagedecisionofficialProject API key

Get permit lineage

GET/v1/permits/{permit_id}/mcp-tool-callsdecisionofficialProject API key

List permit MCP tool-call evidence

POST/v1/permits/{permit_id}/revokedecisionofficialProject API key with admin scope

Revoke permit

POST/v1/permits/{permit_id}/usagedecisionofficialProject API key with admin scope

Report permit usage

POST/v1/permits/dry-rundecisionofficialProject API key

Preview permit

GET/v1/permits/exportdecisionofficialProject API key

Export permits

POST/v1/proxy/anthropicexecutionofficialProject API key

Proxy to Anthropic

POST/v1/proxy/googleexecutionofficialProject API key

Proxy to Google

POST/v1/proxy/metaexecutionofficialProject API key

Proxy to Meta

POST/v1/proxy/openaiexecutionofficialProject API key

Proxy to OpenAI

POST/v1/proxy/xaiexecutionofficialProject API key

Proxy to xAI

GET/v1/public/status/summarystatusofficialPublic

Get public status summary

GET/v1/requests/{request_id}/timelinelifecycleofficialProject API key

Get request timeline

POST/v1/sessions/{session_id}/google-gemini-tool-runsexecutionofficialProject API key

Dispatch governed Google Gemini tool run

GET/v1/sessions/{session_id}/google-gemini-tool-runs/{run_id}lifecycleofficialProject API key

Get Google Gemini tool-run signed evidence

GET/v1/sessions/{session_id}/mcp-tool-callslifecycleofficialProject API key

List session MCP tool-call evidence

POST/v1/sessions/{session_id}/openai-responses-tool-runsexecutionofficialProject API key

Dispatch governed OpenAI Responses tool run

GET/v1/sessions/{session_id}/openai-responses-tool-runs/{run_id}lifecycleofficialProject API key

Get OpenAI Responses tool-run signed evidence

POST/v1/sessions/{session_id}/search-evidencelifecycleofficialProject API key

Record search policy evidence

GET/v1/sessions/{session_id}/search-evidence/{search_id}lifecycleofficialProject API key

Get search policy evidence

GET/v1/webhookslifecycleofficialProject API key

List webhooks

POST/v1/webhookslifecycleofficialProject API key

Create webhook

DELETE/v1/webhooks/{subscription_id}lifecycleofficialProject API key

Delete webhook

GET/v1/webhooks/{subscription_id}lifecycleofficialProject API key

Get webhook

PATCH/v1/webhooks/{subscription_id}lifecycleofficialProject API key

Update webhook

GET/v1/webhooks/{subscription_id}/deliverieslifecycleofficialProject API key

List webhook deliveries

POST/v1/webhooks/{subscription_id}/testlifecycleofficialProject API key

Test webhook

Last updated on Edit this page on GitHub