← Back to API Reference overview

AI Assistant

Context-aware AI assistant that delegates to specialized agents based on the resource being edited.

Shortcut: ⌘K

#The AIDisplayMessage is a user-visible message for rendering object

AIDisplayMessage is a user-visible message for rendering

id

string

sender

string

text

string

timestamp

string (date-time)
GET/v1/ai/conversationRequires auth

#Get AI conversation

Get the display-ready chat history for a specific context.

#Parameters

query parameters

contextType

stringquery

contextId

stringquery

#Response

200

Everything worked as expected.

messages

array<object>

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

POST/v1/ai/messageRequires auth

#Send AI message

Send a message to the AI assistant. The context type determines which specialized agent handles the request.

#Parameters

This endpoint does not accept any parameters.

#Request body

contextId

string

ID of the resource being edited (dashboard ID, workflow ID, link ID)

contextType

string (enum)

AI context types

Allowed values
AI_CONTEXT_TYPE_UNSPECIFIED
AI_CONTEXT_TYPE_ANALYTICS_DASHBOARD
AI_CONTEXT_TYPE_WORKFLOW
AI_CONTEXT_TYPE_LINK

message

string

The user's message

#Response

200

Everything worked as expected.

appliedActions

array<string>

contextUpdated

boolean

True if the agent modified the resource (frontend should refresh)

responseText

string

uiActions

array<object>

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.

DELETE/v1/ai/conversationRequires auth

#Clear AI conversation

Clear the conversation history for a specific context.

#Parameters

query parameters

contextType

stringquery

contextId

stringquery

#Response

200

Everything worked as expected.

No structured schema available for this section.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

objectRequired

Wrapped error response.