Get Chat Conversations

get/v1/chat-conversations/{chat_conversation_id}

Returns a single AI chat conversation by id, including its full message log and accumulated context. Read only, no side effects. Scoped to the authenticated workspace.

Requires a bearer token: Authorization: Bearer <token>.

Path parameters

Name	Type	Required	Description
chat_conversation_id	string <uuid>	Yes	UUID of the chat conversation.e.g. 2f3a4b5c-6d7e-4f80-9a1b-2c3d4e5f6a7b

Request

cURL

curl -X GET https://api.wellapp.ai/v1/chat-conversations/{chat_conversation_id} \
  -H "Authorization: Bearer $WELL_API_TOKEN"

Responses

200 — The chat conversation.

{
  "data": {
    "type": "chat_conversation",
    "id": "2f3a4b5c-6d7e-4f80-9a1b-2c3d4e5f6a7b",
    "attributes": {
      "title": "Reconcile Mercury inflows for May",
      "thread_id": "9b8a7c6d-5e4f-4031-8271-0a9b8c7d6e5f",
      "mode": "analyst",
      "source": "web",
      "page_path": "/workspaces/foldspace/records/transactions",
      "active_tab_key": "transactions",
      "message_count": 2,
      "total_tokens": 1842,
      "messages": [
        {
          "role": "user",
          "content": "Match the Mercury inflows to open invoices."
        },
        {
          "role": "assistant",
          "content": "Found 3 matches, one needs review."
        }
      ],
      "context": {
        "workspace": "Foldspace AI"
      },
      "tabs": [
        {
          "key": "transactions",
          "label": "Transactions"
        }
      ],
      "created_at": "2026-06-07T11:05:40.000Z",
      "updated_at": "2026-06-07T11:31:09.000Z"
    }
  }
}

401 — Missing or invalid bearer token.

{
  "code": "UNAUTHORIZED",
  "status": 401,
  "title": "Unauthorized",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

404 — No chat conversation exists with the supplied id.

{
  "code": "NOT_FOUND",
  "status": 404,
  "title": "Not Found",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}