Skip to main content
POST
Create Session

Authorizations

x-api-key
string
header
required

Body

application/json

Open a session against a catalog workflow (catalog_slug) or a DB revision (revision_id). Exactly one source must be supplied.

catalog_slug
string | null
Required string length: 1 - 128
revision_id
string<uuid> | null

Response

Successful Response

Session metadata returned by POST /sessions and GET /sessions/{id}.

Exactly one of catalog_slug / revision_id is set, reflecting which source the session was opened against.

session_id
string
required
graph
GraphMeta · object
required

The small graph descriptor surfaced to a client on session start / GET.

current_step_id
string | null
required
completed_steps
string[]
required
context_vars
Context Vars · object
required
step_count
integer
required
last_signal
string | null
required
created_at
string<date-time>
required
catalog_slug
string | null
revision_id
string<uuid> | null
awaiting_approval
boolean
default:false