Sign in
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"
  }
}

Changes

Changed in 3 of the 134 revisions of this API.24

  • 08c227b95b1a2See the full diff
    • ○

      added the new optional request property provider

      new-optional-request-property

    • ○

      added the optional property provider to the response with the 201 status

      response-optional-property-added

  • ea20de899fa92See the full diff
    • ●

      removed the request property provider

      request-property-removed

    • ●

      removed the optional property provider from the response with the 201 status

      response-optional-property-removed

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 7c4242de9f982See the full diff
    • ○

      added the new optional request property provider

      new-optional-request-property

    • ○

      added the optional property provider to the response with the 201 status

      response-optional-property-added