Conversations

Get a conversation with its messages

Returns one conversation and its full message transcript, including visitor messages, AI replies, human agent replies, and internal notes.

GET/api/v1/conversations/{id}

Responds 404 if the conversation belongs to another workspace, so ids cannot be enumerated.

Path parameters

Prop

Type

Prop

Type

Every error shares one envelope.

curl https://www.hey.support/api/v1/conversations/<id> \
  -H 'Authorization: Bearer hs_live_…'

List conversations

Returns a paginated list of chat conversations for the workspace, newest first.

Update a conversation (tags, resolved state)

Updates the operator-owned fields of a conversation.