Skip to main content
GET
Get chat histories for an assistant

Authorizations

Authorization
string
header
required

An API key from your Devic console, sent as Authorization: Bearer <key>. An embedded front end sends a tenant-session token instead, so no API key reaches the browser, and an OAuth integration sends its access token. Missing, invalid or expired credentials get a 401. See Authentication.

Path Parameters

identifier
string
required

Identifier of the assistant

Query Parameters

limit
integer<int32>
default:10

Conversations per page. Values above 100 are capped.

Required range: 1 <= x <= 100
offset
integer<int32>
default:0

Conversations to skip

Required range: x >= 0
omitContent
boolean
default:false

Send true to leave chatContent out and get only what describes each conversation.

tenantId
string

Only conversations of this tenant

subtenantId
string

Only conversations of this end user inside the tenant

Response

A page of conversations

A page of conversations.

histories
object[]
required

The conversations of this page, newest first

total
number
required

How many conversations match, ignoring pagination

Example:

42

offset
number
required

Offset this page was taken at

Example:

0

limit
number
required

Page size that was applied

Example:

10