Channels

List the channel's conversations

A cursor page of the channel's conversations, newest first. A conversation is one address's dialogue on the channel — the continuity anchor that resumes the same runtime session instead of starting fresh per message — so this is the read path for who has talked to the channel and which actor/session their dialogue resolved to. Conversations are created by the inbound path (the WhatsApp webhook, the Discord gateway worker) when a real message arrives; there is no way to create one directly.

get/v1/projects/{project_id}/channels/{channel_id}/conversations

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/channels/{channel_id}/conversations
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Query parameters

limitinteger

Results per page, 1 to 100 (default 50). Above 100 it is clamped; below 1 or not an integer it is 400.

cursorstring

Opaque pagination cursor from a previous response's next_cursor.

identifierstring
Example:discord:dm:425678901234567890

Filter to one address by the identifier conversations carry (discord:dm:<user_id>, discord:thread:<guild_id>:<channel_id>, whatsapp:dm:<phone>), in this channel's kind; any other form is 400. At most one row matches.

Response

A page of conversations.

next_cursorstring nullable required

Cursor for the next page, or null when there are no more.

Example response

{
  "data": [
    {
      "id": "conv_V1StGXR8Z5jdHi6B",
      "project_id": "proj_V1StGXR8Z5jdHi6B",
      "channel_id": "chan_V1StGXR8Z5jdHi6B",
      "address_id": "addr_V1StGXR8Z5jdHi6B",
      "route_id": "route_V1StGXR8Z5jdHi6B",
      "identifier": "whatsapp:dm:425678901234567890",
      "actor_id": "actor_V1StGXR8Z5jdHi6B",
      "session_id": "sess_V1StGXR8Z5jdHi6B"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.