Skip to main content
List user conversations
curl --request GET \
  --url https://api.dimedove.com/v1/apps/{app_id}/users/{external_user_id}/conversations \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "<string>",
      "created_at": 123,
      "object": "conversation",
      "external_user_id": "<string>",
      "title": "<string>",
      "generated_title": {
        "en-ca": "<generated title in English>",
        "fr-ca": "<generated title in French>"
      }
    }
  ],
  "object": "list",
  "first_id": "<string>",
  "last_id": "<string>",
  "has_more": false
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
app_id
string
required

The unique identifier of the app.

​
external_user_id
string
required

The external user identifier to filter conversations by.

Query Parameters

​
limit
integer
default:20

Maximum number of conversations to return. Range: 1-100.

​
after
string

A cursor for forward pagination. Returns conversations created after the conversation with this ID.

​
before
string

A cursor for backward pagination. Returns conversations created before the conversation with this ID.

​
order
string
default:desc

Sort order by creation time. Either 'asc' or 'desc'.

Response

OK

​
data
ConversationSchema · object[]
required

The array of conversation objects for the current page.

​
object
string
default:list

The object type. Always 'list'.

​
first_id
string | null

The ID of the first conversation in the returned page. Null if the list is empty.

​
last_id
string | null

The ID of the last conversation in the returned page. Null if the list is empty.

​
has_more
boolean
default:false

Whether there are additional conversations beyond this page. Use the 'after' or 'before' query parameters to paginate.