List assistant conversations

Returns AI assistant conversations, newest first.

GET /v1/assistant/conversations

Bearer token scope conversations:read

curl 'https://api.ferndesk.com/v1/assistant/conversations?start_cursor=eyJ2IjoxLCJrIjpbIjIwMjYtMDEtMDEiLCJhcnRfMSJdfQ&page_size=20&feedback=negative&coverage=none&start_date=2026-01-01&end_date=2026-01-31' \
  --request GET \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "results": [
    {
      "id": "conv_01JXY9AZK4KV",
      "createdAt": "2026-01-15T18:25:43.511Z",
      "updatedAt": "2026-01-15T18:25:43.511Z",
      "status": "active",
      "source": "widget",
      "pageUrl": "https://example.com/pricing",
      "user": {
        "id": "hcusr_01JXYB3S2Y8C",
        "name": "Alice Example"
      },
      "summary": "Asked how to rotate an API key.",
      "coverage": "covered",
      "feedback": "positive",
      "escalated": false,
      "messageCount": 4
    }
  ],
  "has_more": true,
  "next_cursor": "eyJ2IjoxLCJrIjpbIjIwMjYtMDEtMDEiLCJhcnRfMSJdfQ"
}

Cursor-paginated conversations. With a feedback or coverage filter the scan is bounded to 10 windows per request, so a page may come back short with has_more true; follow next_cursor to continue the scan without skipping matches

Query parameters

· 6

start_cursor string

Opaque cursor taken from the previous response’s next_cursor.

page_size integer · min: 1· max: 100· default: 20

Items per page.

feedback string · enum

Restricts the list to one thumbs rating.

values

all
positive
negative
none

coverage string · enum

Restricts the list to one coverage verdict.

values

all
covered
partial
none
irrelevant

start_date string

Earliest date to include.

end_date string

Latest date to include.

Query parameters

Responses