API reference

The runtime Worker serves exactly three public endpoints, and never PostgreSQL — the autocomplete hot path resolves, authorizes, meters, then reads a compiled cache/KV artifact (DEC-EDGE-001). Every SDK binding in the integration guides calls these underneath; this reference is for calling them directly.

• GET /v1/query — the autocomplete endpoint

  Call the runtime Worker directly for pre-ranked autocomplete suggestions — the endpoint every SDK binding calls underneath.

  Copy GET /v1/query — the autocomplete endpoint instructions for AI / LLM

• GET /v1/bootstrap — session policy and version resolution

  Resolve a publishable key to its list identity, active version hash and effective query policy in one call, before the first query.

  Copy GET /v1/bootstrap — session policy and version resolution instructions for AI / LLM

• POST /v1/selection — report which suggestion was chosen

  Tell AutoSugges which suggestion a user picked, so future ranking for that list can improve. Entirely optional and fire-and-forget.

  Copy POST /v1/selection — report which suggestion was chosen instructions for AI / LLM

• Error codes

  The complete typed error vocabulary — every code, its HTTP status, whether it is safe to retry, and what to do about it.