Skip to main content
GET
/
1
/
agents
/
{agentId}
/
conversations
curl
curl --request GET \
  --url 'https://example.algolia.net/agent-studio/1/agents/lorem/conversations?startDate=lorem&endDate=lorem&includeFeedback=true&feedbackVote=0&page=1&limit=20' \
  --header 'accept: application/json' \
  --header 'x-algolia-api-key: ALGOLIA_API_KEY' \
  --header 'x-algolia-application-id: ALGOLIA_APPLICATION_ID' \
  --header 'x-algolia-secure-user-token: lorem'
{
  "data": [
    {
      "agentId": "<string>",
      "createdAt": "<string>",
      "id": "<string>",
      "updatedAt": "<string>",
      "conversationMetadata": {
        "cachedAt": "<string>"
      },
      "feedback": [
        {
          "agentId": "<string>",
          "createdAt": "<string>",
          "id": "<string>",
          "messageId": "<string>",
          "tags": [
            "<string>"
          ],
          "updatedAt": "<string>",
          "vote": 123,
          "model": "<string>",
          "notes": "<string>"
        }
      ],
      "isFromDashboard": false,
      "lastActivityAt": "<string>",
      "messageCount": 0,
      "title": "<string>",
      "totalInputTokens": 0,
      "totalOutputTokens": 0,
      "totalTokens": 0,
      "userToken": "<string>"
    }
  ],
  "pagination": {
    "limit": 123,
    "page": 123,
    "totalCount": 123,
    "totalPages": 123
  }
}
Required ACL: logs

Authorizations

x-algolia-application-id
string
header
required

Your Algolia application ID.

x-algolia-api-key
string
header
required

Your Algolia API key with the necessary permissions to make the request. Permissions are controlled through access control lists (ACL) and access restrictions. The required ACL to make a request is listed in each endpoint's reference.

Headers

X-Algolia-Secure-User-Token
string | null

The X-Algolia-Secure-User-Token.

Path Parameters

agentId
required

The agentId.

Query Parameters

endDate
string | null

Filter conversations created before this date (format: YYYY-MM-DD).

feedbackVote
integer | null

Filter by feedback value (requires includeFeedback=true).

Required range: 0 <= x <= 1
includeFeedback
boolean | null
default:false

Include feedback per conversation.

limit
integer
default:20

Items per page.

Required range: 1 <= x <= 100
page
integer
default:1

Page number.

Required range: x >= 1
startDate
string | null

Filter conversations created after this date (format: YYYY-MM-DD).

Response

Successful Response.

data
conversationBaseResponse · object[]
required
pagination
paginationMetadata · object
required
Last modified on June 11, 2026