Skip to content

HTTP API

detent-authority --authority CONFIG runs the durable authority, which speaks HTTP/1.1 with JSON bodies, over TLS when its configuration enables publisher TLS.

EndpointsAuthentication
/v2/*Bearer token
/v1/healthNone

Examples on these pages are written as REST snippets:

GET /v1/health

Hover a snippet and use the copy button to get the equivalent curl command against http://localhost:8317.


  1. Bodies are bounded. Authority request bodies are limited to 256 KiB.
  2. Errors are JSON. A rejected request returns {"error":"..."} with an appropriate status code. Authentication and body-admission failures close the connection.
  3. Identity is exact. Every /v2 request names the authority’s cluster, group and epoch.