Asteria Docs
Chat & Discovery

List Models

List models available to this project. Returns org-enabled models intersected with the project allow-list (if set). Follows Anthropic's model list shape: {data, first_id, last_id, has_more}. Does not include 'asteria' or agent slugs — use GET /v1/agents for those.

GET
/v1/models

Authorization

ApiKey
Authorization<token>

Your API key (sk-ast-...)

In: header

Query Parameters

limit?integer

Maximum number of models to return

Default20
Range1 <= value <= 100
after?|

Cursor for pagination (model_id)

Response Body

application/json

application/json

application/json

curl -X GET "https://api.asteria-labs.com/v1/models"
{
  "object": "list",
  "data": [
    null
  ],
  "first_id": "string",
  "last_id": "string",
  "has_more": false
}
{
  "error": null
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Chat Completions

OpenAI-compatible chat completions endpoint. Supports both streaming (SSE) and non-streaming responses. **Routing modes** — controlled by the `model` + `agent` fields: - **Gateway mode** (`agent` omitted): pure LLM proxy, no system prompt, no tools. Rate limiting and budget enforcement still apply. - **Orchestrator mode** (`agent: "asteria"`): full Asteria agent with RAG, web search, code execution, and sub-agents. - **Custom agent mode** (`agent: "<slug>"`): invoke a shared custom agent by slug. The agent's system prompt and tools are applied.

List Agents

List available agents for the caller's organization. Returns the built-in Asteria orchestrator plus any shared custom agents that have a slug. The `id` field in each entry is the slug to pass as `agent` in POST /v1/chat/completions.