Messages

Send a chat message to the agent

Fire-and-forget: the reply arrives later over the WS bridge → SSE/DB. role is ignored — always inserted as user.

post/agents/{agentId}/messages

Request

  • Base URL: https://api.atako.ai
  • URL: https://api.atako.ai/agents/{agentId}/messages
  • Auth: HTTP bearer

Path parameters

agentIdstring required

Agent id

Request body

contentstring

Required unless attachments is non-empty.

conversationIdstring uuid

Session to read/write. Omitted = the caller's most recently active session (created on demand) — what every client written before sessions existed gets. A session that is not the caller's own on this agent answers 404.

attachmentsstring[]

Ids of files you uploaded (/client/files) that this agent can read — its dedicated folder, or granted. Stored in meta.attachments and forwarded to the agent.

Response

idstring uuid required
agentIdstring uuid required
conversationIdstring uuid

Session this message belongs to.

role'user' | 'agent' required
contentstring required
metaobject
flaggedAsErrorboolean

Deprecated — see feedback.

deliveryStatestring
feedback'up' | 'down'

The caller's thumbs up/down on this agent reply, if any.

timestampstring date-time required

Changes

No recorded changes to this operation across all 2 revisions of this API.