Assistant

Read a conversation

A page of one conversation, oldest first. offset and total count every stored message, tool-only turns included, which this list leaves out — so a page can hold fewer than limit, and the list ends when offset + limit reaches total. The newest page is at offset = total - limit.

get/v1/assistant/sessions/{session_id}/messages

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/assistant/sessions/{session_id}/messages
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Query parameters

limitinteger

Results per page, 1 to 100 (default 50). Above 100 it is clamped; below 1 or not an integer it is 400.

offsetinteger

Results to skip. Negative or not an integer it is 400.

Response

The conversation.

totalinteger required

Stored messages in the conversation, tool-only turns included.

limitinteger required
offsetinteger required

The stored messages skipped before this page.

Example response

{
  "data": [
    {
      "id": "doc_V1StGXR8Z5jdHi6B",
      "role": "assistant",
      "content": "You have two projects."
    }
  ],
  "total": 12,
  "limit": 50
}

Changes

No recorded changes to this operation across all 1 revision of this API.