Skip to content

Conversations

Create and continue persistent, brand-aware BrandSuite AI Studio conversations.

4 tools. Each card documents its effect and tools/list input contract.

Conversations

Create and continue persistent, brand-aware BrandSuite AI Studio conversations.

4 tools
list_conversations
conversation
read only

List the user’s persisted BrandSuite AI Studio conversations for the authorized workspace.

Parameters

brandIduuid
Optional

Optional brand scope.

statusstring
Optional

Conversation status.

Values: active, archived

limitinteger
Optional
Default: 30

Maximum conversations returned.

get_conversation
conversation
read only

Return a bounded message history for one user-owned BrandSuite conversation.

Parameters

conversationIduuid
Required

Conversation ID.

limitinteger
Optional
Default: 50

Maximum recent messages returned.

start_brand_conversation
conversation
local write

Create an explicit, persistent and brand-aware AI Studio conversation.

Parameters

brandIduuid
Required

Authorized BrandSuite brand ID.

titlestring
Optional

Optional conversation title.

externalThreadIdstring
Optional

Optional client thread ID; stored only as a hash for idempotent reuse.

continue_brand_conversation
conversation
local write

Persist a user message, obtain BrandSuite AI guidance and save proposed actions without executing them.

Parameters

conversationIduuid
Required

Conversation ID.

messagestring
Required

User message, up to 12,000 characters.

requestKeystring
Optional

Stable request key for idempotent message replay.

languagestring
Optional
Default: it

Response language.

Values: it, en, fr, de, es, pt, ja, zh