Conversations

Message reference

Roles and statuses returned on conversation messages.

Reference data for the role and status fields returned by the message endpoints.

Roles

RoleDescription
userMessages sent by the API caller (your prompts)
assistantResponses from the agent
systemSystem notifications, including error messages from nairid
progressIntermediate streaming events emitted by the agent. The content field is a JSON envelope ({"job_id":"...","progress_type":"text","text_delta":"..."}). Most callers can skip these.

Statuses

StatusDescription
queuedMessage is waiting to be processed (no agent available yet)
pendingMessage is being processed by an agent
completedMessage has been processed successfully
failedMessage processing failed. Check for a sibling system message for details.

On this page