Skip to main content
GET
curl
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.

includeImpactAnalytics
boolean
default:false

Include outcome signals (hasView, hasClick, hasConversion) for the conversation.

includeMessageEvents
boolean
default:false

Include Insights events attributed to each assistant message.

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
analyticsDegraded
boolean
default:false
conversationMetadata
conversationMetadata Ā· object | null

Public metadata exposed on conversation responses.

feedback
feedbackResponse Ā· object[] | null
impactAnalytics
impactAnalytics Ā· object | null

Views, clicks, and conversions attributed to the conversation.

Returned only when includeImpactAnalytics=true. null means the API could not supply the data -- NOT that there are zero outcomes -- and the response sets analyticsDegraded to true. Render that case as a data-load error rather than as zero-value badges.

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 October 12, 2026