Conversations

List conversation messages

Returns all messages (documents) attached to a conversation, ordered by position

get/v1/projects/{project_id}/conversations/{conversation_id}/messages

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/conversations/{conversation_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)

Path parameters

conversation_idstring required
Example:conv_V1StGXR8Z5jdHi6B

Conversation ID

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

List of messages

totalinteger
limitinteger
offsetinteger

Example response

{
  "data": [
    {
      "document_id": "doc_V1StGXR8Z5jdHi6B",
      "role": "user",
      "actor_id": "actor_V1StGXR8Z5jdHi6B",
      "agent_id": "agent_V1StGXR8Z5jdHi6B",
      "metadata": {
        "author": "John",
        "revision": 2
      },
      "idempotency_key": "wamid.HBgLNTUxMTk4..."
    }
  ]
}

Changes

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