Skip to main content
GET
/
1
/
agents
/
{agentId}
/
conversations
/
{conversationId}
curl
curl --request GET \
  --url 'https://example.algolia.net/agent-studio/1/agents/lorem/conversations/export?startDate=lorem&endDate=lorem' \
  --header 'accept: application/json' \
  --header 'x-algolia-api-key: ALGOLIA_API_KEY' \
  --header 'x-algolia-application-id: ALGOLIA_APPLICATION_ID'
{
  "agentId": "<string>",
  "createdAt": "<string>",
  "id": "<string>",
  "messages": [
    {
      "conversationId": "<string>",
      "createdAt": "<string>",
      "id": "<string>",
      "parts": [
        {
          "text": "<string>",
          "type": "text"
        }
      ],
      "updatedAt": "<string>",
      "inputTokens": 123,
      "model": "<string>",
      "outputTokens": 123,
      "turnContext": {}
    }
  ],
  "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>"
}
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.

conversationId
string
required

The conversationId.

Query Parameters

includeFeedback
boolean
default:false

Include feedback for the conversation.

Response

Successful Response.

Response model for a conversation with all its messages.

agentId
string
required
createdAt
string
required
id
string
required
messages
messageResponse Ā· object[]
required
updatedAt
string
required
conversationMetadata
conversationMetadata Ā· object

Public metadata exposed on conversation responses.

feedback
feedbackResponse Ā· object[] | null
isFromDashboard
boolean
default:false
lastActivityAt
string | null
messageCount
integer
default:0
title
string | null
totalInputTokens
integer
default:0
totalOutputTokens
integer
default:0
totalTokens
integer
default:0
userToken
string | null
Last modified on June 11, 2026