Create a new thread
Mints a new thread for the authenticated caller. The thread starts with no messages; the title is set when the first user message lands. The optional `model` field locks the thread to that model id; threads default to the server's default model when the field is omitted.
Mints a new thread for the authenticated caller. The thread starts with no messages; the title is set when the first user message lands. The optional model field locks the thread to that model id; threads default to the server's default model when the field is omitted.
Authorization
bearerAuth A bearer token. The Account routes accept a Privy access token; the MCP transport accepts an sk- API key issued by POST /account/api-keys.
In: header
Request Body
application/json
The thread to create. The body is optional; a thread with the default model is created when the body is empty.
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/inference/threads" \ -H "Content-Type: application/json" \ -d '{}'{ "id": "string", "title": "string", "model": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z"}List the caller's threads GET
Returns every thread the authenticated caller owns, newest activity first.
Read a thread and its messages GET
Returns one thread the caller owns, plus every message in it in order. Attachment metadata is included in the message entries; the bytes are fetched via a separate endpoint so a client that does not need them does not pay the bandwidth.