v1

latestOpenAPI 3.0.02026-07-26870415.2 KB

conversations

List messages for conversation

Returns the paginated transcript for a conversation. Messages are chronological by default; reuse cursor with the same filters to continue pagination.

get/v1/conversations/{id}/messages

Path parameters

idstring required

Canonical conversation id.

Example:ph77c0dy0mgdpzmqz6tesry8w184002s

Query parameters

workspace_idstring

Optional workspace override. If omitted, Conduit resolves the conversation's workspace automatically.

Example:j57demo8f8x7c9v0n2q4r6t8y1u3i5o

limitinteger

cursorstring

order'asc' | 'desc'

Response

Conversation messages

next_cursorstring nullable required

has_moreboolean required

Example response

{
  "data": [
    {
      "id": "yh7t5azsr0zpfpyf67vtce0j6n844y1e",
      "workspace_id": "j57demo8f8x7c9v0n2q4r6t8y1u3i5o",
      "conversation_id": "ph77c0dy0mgdpzmqz6tesry8w184002s",
      "channel": "unthreaded_email",
      "body": "Hi there, can you confirm check-in time?",
      "direction": "outbound",
      "status": "sent",
      "sent_at": "2026-04-03T03:15:02.000Z",
      "created_at": "2026-04-03T03:15:04.000Z",
      "sender": {
        "user_id": "m48k3v7p2q9x5t1w8r6n4j0y3u2i5o7a",
        "external_id": null,
        "name": "Alex M"
      },
      "attachments": [
        {
          "url": "https://files.conduit.ai/storage/kg2abc123def456",
          "content_type": "image/png",
          "name": "screenshot.png"
        }
      ]
    }
  ],
  "next_cursor": null,
  "has_more": false
}