Skip to main content
Sinas has two API layers:

Runtime API (/)

The runtime API is mounted at the root. It handles authentication, chat, execution, state, file operations, and discovery. These are the endpoints your applications and end users interact with.

Management API (/api/v1/)

The management API handles CRUD operations on all resources. These are typically used by admins, the console UI, and configuration tools.

OpenAI SDK Adapter (/adapters/openai)

An OpenAI SDK-compatible API that maps to Sinas agents and LLM providers. Point any OpenAI SDK client at this endpoint to use Sinas agents.
Agents are listed as models with names like agent:namespace/name. Provider models are listed with their provider prefix.

Interactive API Docs

Swagger UI is available at /docs (runtime API), /api/v1/docs (management API), and /adapters/openai/docs (OpenAI adapter) for exploring all endpoints and schemas interactively.

Discovery Endpoints

The discovery API returns resources visible to the current user, optionally filtered by app context:
Pass an app context via the X-Application header or ?app=namespace/name query parameter to filter results to a specific app’s exposed namespaces.