Messages

Open a new chat session with an agent

The session gets its own engine-side key (chat:<id>), so its context is isolated from every other session of the same agent.

post/agents/{agentId}/conversations

Request

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

Path parameters

agentIdstring required

Agent id

Request body

titlestring nullable
metaobject nullable

Response

idstring uuid required
agentIdstring uuid required
keystring required

Opaque engine-side key of this thread — the bare user id for the historical thread, chat:<conversationId> for every session created since. Read-only.

titlestring nullable required

Derived from the first user message when not set explicitly.

metaobject

Free-form per-session payload.

archivedboolean required
unreadCountinteger required

Agent messages newer than this session's read cursor.

lastReadAtstring date-time nullable
lastMessageAtstring date-time nullable
createdAtstring date-time required

Changes

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