agent

Create agent session

Creates a new agent session and sends the first message.

post/agent/sessions

Query parameters

remoteNodestring

name of the remote node

messagestring required

User's input text

modelstring

LLM model ID to use

safeModeboolean

Enable approval prompts for dangerous commands

soulIdstring

Soul ID to use for this session (overrides default)

sessionIdstring

Optional client-provided session ID (UUID v4) for idempotent creation. Only used by the create-session endpoint; ignored by the chat endpoint.

Session created

sessionIdstring required

statusstring required