v1

latestOpenAPI 3.0.3BSL2026-07-17133415718.8 KB

Message

Get all messages for a given topic

If the topic is a RAG topic then the response will include Chunks first on each message. The structure will look like [chunks]||mesage. See docs.trieve.ai for more information.

get/api/messages/{messages_topic_id}

Path parameters

messages_topic_idstring uuid required

The ID of the topic to get messages for.

Headers

TR-Datasetstring uuid required

The dataset id or tracking_id to use for the request. We assume you intend to use an id if the value is a valid uuid.

Response

All messages relating to the topic with the given ID

completion_tokensinteger nullable

contentstring required

created_atstring date-time required

dataset_idstring uuid required

deletedboolean required

idstring uuid required

prompt_tokensinteger nullable

rolestring required

sort_orderinteger required

topic_idstring uuid required

updated_atstring date-time required

Example response

[
  {
    "completion_tokens": 300,
    "content": "Hello, world!",
    "created_at": "2021-01-01 00:00:00.000",
    "dataset_id": "e3e3e3e3-e3e3-e3e3-e3e3-e3e3e3e3e3e3",
    "deleted": false,
    "id": "e3e3e3e3-e3e3-e3e3-e3e3-e3e3e3e3e3e3",
    "prompt_tokens": 300,
    "role": "user",
    "sort_order": 1,
    "topic_id": "e3e3e3e3-e3e3-e3e3-e3e3-e3e3e3e3e3e3",
    "updated_at": "2021-01-01 00:00:00.000"
  }
]