The full OpenAPI 3.1 spec for Trail's external HTTP surface. Four endpoints, all bearer-token protected, all stable under /api/v1/:

• POST /api/v1/knowledge-bases/{kbId}/retrieve — grounded context retrieval (Pattern C)
• POST /api/v1/queue/candidates — submit a candidate Neuron
• POST /api/v1/chat — synthesised answer with citations (Pattern A)
• GET /api/v1/knowledge-bases/{kbId}/search — FTS5 keyword search

The spec is hand-written from packages/shared/openapi.yaml in the trail repository. Direct YAML download: openapi-trail.yaml.