Messages

List the caller's chat sessions with an agent

Most recently active first. Archived sessions are excluded unless includeArchived=true.

get/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

Query parameters

includeArchived'true' | 'false'

Include archived sessions.

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.