Thrive AI Health
Api reference

Update thread metadata (title only)

Only the thread title can be edited; messages are immutable. Partners surface this as a rename action in the conversation list UI.

PATCH
/v1/users/{user_id}/threads/{thread_id}

Authorization

MemberBearer
AuthorizationBearer <token>

Member-scoped JWT minted by POST /v1/auth/token. Required on every /v1/users/{user_id}/... route; the token's sub claim must match the path user_id.

In: header

Path Parameters

user_id*User Id
Formatuuid
thread_id*Thread Id
Formatuuid

Header Parameters

org-id?string|null
x-user-id?string|null
x-request-id?string|null
traceparent?string|null
Idempotency-Key?|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X PATCH "https://loading/v1/users/497f6eca-6276-4993-bfeb-53cbbbba6f08/threads/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "title": "string"  }'
{
  "data": {
    "thread_id": "1de43264-67cb-48af-89f9-e865c375bb84",
    "title": "string",
    "updated_at": "2019-08-24T14:15:22Z"
  }
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

List all conversation threads for a user

Threads persist across text and voice sessions; one thread can contain both modalities. Sort order is `updated_at` descending. `messages[]` is omitted from list rows — fetch messages via `GET /threads/{thread_id}/messages`.

Retrieve messages in a thread

Paginated message history including both text-chat messages and voice-session transcripts (the `modality` field distinguishes). Optional `after` / `before` query params narrow the time range — useful for incremental refreshes.