GET
/
v2
/
threads
/
{threadId}
/
messages
curl --request GET \
  --url https://api.langtail.com/v2/threads/{threadId}/messages \
  --header 'X-API-Key: <x-api-key>'
{
  "object": "list",
  "data": [
    {
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "threadId": "<string>",
      "content": [
        {
          "role": "user",
          "content": "Hello"
        }
      ],
      "requestLogId": "<string>",
      "metadata": {}
    }
  ],
  "first_id": "<string>",
  "last_id": "<string>",
  "has_more": true
}

This endpoint allows you to retrieve a list of messages for a specific thread. Messages are an essential part of the thread, representing the conversation history between the user and the AI assistant.

​
Pagination

This endpoint supports pagination in the same way as the Threads API. It uses the limit parameter to specify the maximum number of messages per request, and the after parameter as a cursor for pagination. The response includes a has_more parameter to indicate if more results are available.

For detailed information on how pagination works, refer to the Threads API documentation.

Headers

​
X-API-Key
string
required

Your Langtail API Key

Example:

"<LANGTAIL_API_KEY>"

Path Parameters

​
threadId
string
required

The ID of the thread to retrieve messages from.

Query Parameters

​
limit
number | null

The maximum number of threads to return. Default is 100.

​
after
string | null

A cursor for use in pagination. 'after' is a thread ID that defines your place in the list. For instance, if you make a list request and receive 100 threads, ending with thread 'xyz', your subsequent call can include after='xyz' in order to fetch the next page of the list. Pagination works the same as in the OpenAI API https://platform.openai.com/docs/api-reference/assistants/listAssistants.

​
order
enum<string> | null
default:asc

The order of the messages. Default is 'asc' (oldest first). Use 'desc' for newest first.

Available options:
asc,
desc

Response

200
application/json

Successful response

The response is of type object.