GET
/
v2
/
threads
/
{threadId}
cURL
curl --request GET \
  --url https://api.langtail.com/v2/threads/{threadId} \
  --header 'X-API-Key: <x-api-key>'
{
  "id": "<string>",
  "createdAt": 123,
  "projectId": "<string>",
  "deletedAt": "2023-11-07T05:31:56Z",
  "createLog": {
    "id": "<string>",
    "url": "<string>",
    "stream": true,
    "metadata": "<string>",
    "promptId": "<string>",
    "threadId": "<string>",
    "assistant": true,
    "projectId": "<string>",
    "requestIP": "<string>",
    "startedAt": "2023-11-07T05:31:56Z",
    "variables": "<string>",
    "parameters": "<string>",
    "promptSlug": "<string>",
    "doNotRecord": true,
    "environment": "<string>",
    "openAIKeyId": "<string>",
    "projectSlug": "<string>",
    "requestData": "<string>",
    "deploymentId": "<string>",
    "organizationId": "<string>",
    "projectAPIKeyId": "<string>",
    "organizationSlug": "<string>",
    "deploymentVersion": "<string>",
    "promptHistoryHash": "<string>",
    "openAIOrganization": "<string>"
  },
  "metadata": {
    "user_id": "user_123",
    "conversation_topic": "product_inquiry",
    "priority": "high"
  }
}
This endpoint retrieves a single thread by its unique identifier. It provides detailed information about a specific conversation thread, including its creation timestamp, associated project, and any custom metadata.

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.

Response

Successful response

​
id
string
required

The unique identifier for the thread.

​
createdAt
integer
required

The Unix timestamp (in seconds) of when the thread was created.

​
projectId
string
required

The ID of the project this thread belongs to.

​
deletedAt
string<date-time> | null

The timestamp when the thread was deleted, if applicable.

​
createLog
object | null

A log created by the first message that creates the thread.

​
metadata
object | null

A set of key-value pairs that can be attached to the thread. This can be used to store additional information about the thread to facilitate filtering or organization.

Example:
{
  "user_id": "user_123",
  "conversation_topic": "product_inquiry",
  "priority": "high"
}