Saltar al contenido principal
POST
Open a lane

Autorizaciones

Authorization
string
header
requerido

Enforced on every transport, with no exempt operation. A person's request must carry a JWT issued by the configured identity provider, which the host verifies itself against that issuer's key set: signature, issuer, expiry, and the person and organisation it names. Requests without a valid one receive 401 NRY-0011 — except a request with no token on a laptop's socket from the OS user the kernel names as the host's own, which is that machine's user.

Parámetros de ruta

sessionId
string<uuid>
requerido

The session's id.

Cuerpo

application/json

Request to open a lane. kind side opens a side conversation; kind subagent delegates to a named agent recipe — agent is required in that case, and ignored for kind side.

kind
enum<string>
requerido
Opciones disponibles:
side,
subagent
message
string
requerido

The initial message that starts the lane's first turn.

Minimum string length: 1
agent
string

The agent recipe to delegate to. Required when kind is subagent. Ignored when kind is side: a side conversation always runs the host's read-only explorer, and the lane comes back naming it — an unknown name here is neither honoured nor refused.

Maximum string length: 128
idempotencyKey
string

createMessage's key, for the message that starts the lane, so a create whose answer was lost can be repeated safely. A create carrying a key its session already holds opens nothing and starts nothing: it is answered 201 with the lane that message is on, whatever else this body says. Absent, every create opens a lane.

Required string length: 1 - 255

Respuesta

The opened lane.

A parallel track of execution inside a session. The main lane carries the primary conversation; subagent lanes carry delegated work; side lanes carry conversations opened mid-run without interrupting the work. Workflow lanes carry one step of a workflow run: they have no parent lane and sit at depth 0, because a run starts from a request rather than from anybody's turn.

id
string<uuid>
requerido
sessionId
string<uuid>
requerido
kind
enum<string>
requerido
Opciones disponibles:
main,
side,
subagent,
workflow
status
enum<string>
requerido
Opciones disponibles:
idle,
running,
waiting,
closed
createdAt
string<date-time>
requerido
agent
string

The agent recipe running in the lane, for subagent and workflow lanes and for a main lane whose session was created under one.

activity
string

What the lane is currently doing, in one line.

Maximum string length: 1024