VirtuousAI
ReferenceChat

List Threads

List chat threads for the current user.

GET
/api/v1/chat/threads

Query Parameters

limit?integer
Default20
Range1 <= value <= 100
cursor?|

Header Parameters

authorization?|
X-API-Key?|
vai_token?|

Response Body

application/json

application/json

curl -X GET "https://loading/api/v1/chat/threads"
{
  "items": [
    {
      "createdAt": "2019-08-24T14:15:22Z",
      "id": "string",
      "lastMessageAt": "2019-08-24T14:15:22Z",
      "lastTurnId": "string",
      "metadata": {},
      "systemPrompt": "string",
      "title": "string",
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  ],
  "nextCursor": "string"
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

List Messages

List messages for a chat thread.

Stream Turn

Start a chat turn and stream the response via SSE. Uses pydantic-ai's native VercelAIAdapter for proper Vercel AI SDK v6 UI Message Stream protocol compliance. The adapter: - Parses the Vercel AI SDK request format automatically - Streams events in the correct protocol format - Handles finish events with usage data Headers: - X-User-Timezone: Optional IANA timezone (e.g., 'America/Denver'). If provided, overrides the user's stored timezone preference. Useful for users who are traveling.