POST
/
v2
/
threads

This endpoint creates a new thread. It allows you to initialize a conversation thread, optionally providing metadata to associate with it.

Headers

X-API-Key
string
required

Your Langtail API Key

Body

application/json
createLog
object

A log object that can be passed to create an initial log for the thread.

metadata
object

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.

Response

200 - application/json
createdAt
string
required

The timestamp when the thread was created.

id
string
required

The unique identifier for the created thread.

projectId
string
required

The ID of the project this thread belongs to.

createLog
object | null

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

deletedAt
string | null

The timestamp when the thread was deleted, if applicable.

metadata
object | null

The metadata associated with the thread, if provided.