API overview

AVAILABLE

Naagmani separates inference from administration.

SurfacePurposeTypical self-hosted script port
OS gatewayModel listing, chat completions, Responses and streaming8080
Local control-plane APIOrganizations, projects, users, permissions, credentials and operations8081
Developer PortalBrowser management interface3001

Your configuration may use different ports or HTTPS hostnames. The hosted control plane can proxy supported gateway requests, but credential requirements still depend on the route. Use the endpoint supplied by your deployment operator.

The gateway registers GET /v1/models, POST /v1/chat/completions and POST /v1/responses. Optional parameters and behavior depend on the selected adapter/model; OpenAI compatibility does not cover every OpenAI API.

Send Authorization: Bearer to authenticated endpoints and Content-Type: application/json with JSON bodies. Management operations require a permitted management credential or an explicitly supported machine capability; a gateway key does not grant unrestricted administration.

See authentication, chat completions, response formats, model listing and streaming.