API Reference
Interactive reference for the Venna gateway HTTP API, generated from the live OpenAPI snapshot.
The reference below is generated from the Venna gateway OpenAPI snapshot
(openapi.json, OpenAPI 3.1). Every operation, schema, and example is rendered
straight from that contract, so the docs always match the API.
Base URL and auth
All endpoints are served under https://gateway.venna.net/v1. Authenticate with
a workspace key (Authorization: Bearer vk_...), a plan session JWT, or x402 —
see Authentication for when to use each.
What's live today
Implemented endpoints lead the navigation and render as available:
Chat
POST /v1/chat/completions — OpenAI-compatible chat.
Responses
/v1/responses — create, retrieve, cancel, input items.
Models
/v1/models — list and retrieve available models.
Embeddings
POST /v1/embeddings — vector embedding generation.
Health
Liveness checks for the gateway.
Network
Venna-specific endpoints exposing live mesh state.
Everything below the Coming soon marker is documented from the spec but not yet served by the gateway — those operations carry a "Not yet implemented" badge.