putty
API ReferenceInference

List the caller's threads

Returns every thread the authenticated caller owns, newest activity first.

GET
/inference/threads

Returns every thread the authenticated caller owns, newest activity first.

Authorization

bearerAuth
AuthorizationBearer <token>

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

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/inference/threads"
{  "threads": [    {      "id": "string",      "title": "string",      "model": "string",      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z"    }  ]}

Read the caller's usage summary GET

Returns the per-day quota state, the per-category breakdown, the hourly buckets the chart renders, and the most recent events the events table shows. One round trip; the dashboard calls it once on page load.

Create a new thread POST

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.