displayName
POST /api/v1/sessions
method
POST
path
/api/v1/sessions
responseShape
{ run: RunRecord, sourceSessionId: string | null } (201) | { error }
authRequired
true
description
Start a new session (optionally forking forkSessionId). Body fields: agent, model?, prompt, cwd?, workspaceId?, forkSessionId?. Source: packages/agent-mux/gateway/src/server.ts:381-415.