Core ConceptsSessions And Conversations

Sessions And Conversations

Last updated 2026-02-07

Rooaak conversations are grouped implicitly by sessionId.

Key behavior

  • POST /v1/agents/:id/messages requires sessionId.
  • Conversation summaries come from GET /v1/agents/:id/conversations.
  • Full history comes from GET /v1/conversations/:id where :id is session id.

Pagination

  • Conversation list uses cursor on lastMessageAt.
  • Conversation history supports limit and cursor on created_at.