Skip to main content
POST
Create Session

Authorizations

X-API-Key
string
header
required

Cookies

wos-session
string
datalab_active_team
string

Body

application/json

Start a session from a template, reopen one on a processor, or — with NEITHER — start a blank session (empty draft, grounding welcome). At most one of template / processor_id.

template
string | null

Template id: picky-tables | extract-schema | jats-fork | wcag | segment.

processor_id
string | null

Public processor id (slug) to reopen a design session on.

flag_id
integer | null

Optional flag to seed the reopened session's context (only with processor_id).

title
string | null
Maximum string length: 255

Response

Successful Response

session
SessionStateResponse · object
required
cursor
integer
required

Max event seq served; pass back as since_seq on the next poll.

events
SessionEventResponse · object[]