Skip to main content
GET
Retrieve ai chat
Required permissions:
  • ai_chat:read

Autorisaties

Authorization
string
header
vereist

An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.

Scopes

ai_chat:read

Padparameters

id
string
vereist

The unique identifier of the AI chat to retrieve.

Voorbeeld:

"aich_xxxxxxxxxxxxx"

Respons

A successful response

An AI-powered chat conversation belonging to a user, with optional scheduled automation.

agent_identifier
enum<string>
vereist

The AI agent that handles this chat. Set when the chat is created and fixed for its lifetime.

Beschikbare opties:
general,
support
blended_token_usage
string
vereist

The total number of tokens consumed across all messages in this conversation.

Voorbeeld:

"123.45"

created_at
string<date-time>
vereist

The datetime the ai chat was created.

Voorbeeld:

"2023-12-01T05:00:00.401Z"

id
string
vereist

The unique identifier for the ai chat.

Voorbeeld:

"aich_xxxxxxxxxxxxx"

last_message_at
string<date-time> | null
vereist

The timestamp of the most recent message in this conversation. Null if no messages have been sent yet.

Voorbeeld:

"2023-12-01T05:00:00.401Z"

message_count
integer
vereist

The total number of messages exchanged in this conversation.

Voorbeeld:

42

notification_preference
enum<string>
vereist

The notification preference for this AI chat. all delivers AI chat notifications and badges, while none mutes them.

Beschikbare opties:
all,
none
title
string | null
vereist

A short descriptive title for this AI chat conversation. Null if no title has been set.

Voorbeeld:

"Weekly Revenue Analysis"

updated_at
string<date-time>
vereist

The datetime the ai chat was last updated.

Voorbeeld:

"2023-12-01T05:00:00.401Z"

user
object
vereist

The user who owns this AI chat conversation.