v106

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-02160524464.6 KB

Sessions

Create run session

Creates a read-only Ask Fabro session bound to the run.

post/api/v1/runs/{id}/sessions

Request body

titlestring

modelstring

Catalog model ID or alias, optionally qualified as provider:selector. A provider-qualified selector may be a canonical model ID, alias, or provider API ID. A value counts as qualified only when the text before the first : names a known provider, so model IDs containing a colon stay whole. Legacy provider/model references remain accepted. The server stores the canonical model ID.

providerstring

LLM provider identifier.

Example request

{
  "provider": "anthropic"
}

Response

Session created

idstring required

Durable session identifier.

run_idstring required

titlestring nullable

status'idle' | 'running' | 'failed' required

modelstring nullable

Canonical model ID selected when the session was created.

providerstring

LLM provider identifier.

created_atstring date-time required

updated_atstring date-time required

Example response

{
  "id": "01HZX6M0P7SE4VJ9Y3X2B8E9QF",
  "provider": "anthropic",
  "active_turn": {
    "id": "01HZX6M29F1CD5YYMHT1F5D7WQ"
  }
}