agent

Send message to agent session

Sends a message to an existing agent session.

post/agent/sessions/{sessionId}/chat

Path parameters

sessionIdstring required

Unique identifier of the agent session

Query parameters

remoteNodestring

name of the remote node

Request body

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.

Response

Message accepted

statusstring required

Changes