Read a conversation

Request

One conversation with its turns: each question, answer, the records it cited and the work it saved. Use this when you need what the assistant already said. turns is a page, oldest first, with total counting every turn; cursor and limit page it. Each answer's citations carry the address you may open, or null; artifacts are what that turn saved that you may open. Another person's conversation, a deleted one and an unknown id are all 404.

Security

bearerKey

Path

idstringrequired

Query

cursorstring, [ 1 .. 500 ] characters

limitinteger, [ 1 .. 100 ]

Default:25

curl -i -X GET \
  'https://docs.societyhealth.co/_mock/docs/openapi/api/v1/conversations/{id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Done.

Bodyapplication/json

okanyrequired

Value:true

dataobject(PublicConversation)required

Response

{
  "ok": true,
  "data": {
    "id": "Cnv7pQ2rS4tU6vW8xY0z",
    "url": "https://hrcledger.com/ask/Cnv7pQ2rS4tU6vW8xY0z",
    "title": "Ohio EHR changes",
    "turns": { … },
    "createdAt": "2026-10-16T13:58:02.000Z",
    "updatedAt": "2026-10-16T14:02:11.000Z"
  }
}