v1

latestOpenAPI 3.1.02026-07-26751285.0 KB

messaging

Submit a message to the central messaging system

Submit a message to the central messaging bus for agent processing. This is the primary endpoint for sending messages to agents, replacing the deprecated agent-specific message endpoints.

The message is submitted to a central channel and the appropriate agent(s) will process it based on the channel and room configuration. This architecture allows for multi-agent conversations and better message routing.

Important: Do not use /api/agents/{agentId}/message - that endpoint no longer exists. All messages should go through this central messaging system.

post/api/messaging/submit

Request body

channel_idstring uuid required

Central channel ID where the message is posted

server_idstring uuid required

Server ID (use '00000000-0000-0000-0000-000000000000' for default)

author_idstring uuid required

ID of the message author (user or agent)

contentstring required

The message content text

in_reply_to_message_idstring uuid

Optional ID of the message being replied to

source_typestring required

Source type (e.g., 'agent_response', 'user_message')

raw_messageobject required

Raw message object containing additional data

metadataobject

Additional metadata including agent_name if from agent

Response

Message submitted successfully

successboolean