AI Assistant API
Leverage AI-powered content generation and automation
AI automations
List the project's automations, with the actions and schedule kinds the form offers
/services/ai/v1/automations/list
Auth
Create (no id) or update an automation
/services/ai/v1/automations/save
Auth
Switch an automation on or off
/services/ai/v1/automations/toggle
Auth
Queue one run now (charged like a scheduled run)
/services/ai/v1/automations/run-now
Auth
Delete an automation and its run history
/services/ai/v1/automations/delete
Auth
Run history of one automation, newest first
/services/ai/v1/automations/runs
Auth
AiDrafts
/services/ai/v1/drafts/status
Auth
/services/ai/v1/drafts/history
Auth
/services/ai/v1/drafts/diff
Auth
/services/ai/v1/drafts/check
Auth
/services/ai/v1/drafts/publish
Auth
/services/ai/v1/drafts/update
Auth
/services/ai/v1/drafts/discard
Auth
Chat
/services/ai/v1/chat/config
Auth
Send Chat Message
/services/ai/v1/chat
Auth
/services/ai/v1/dictation/transcribe
Auth
/services/ai/v1/chat/images/upload
Auth
/services/ai/v1/chat/images/upload-url
Auth
/services/ai/v1/chat/images/delete
Auth
Chat Settings
Get Chat Settings
/services/ai/v1/chat/settings/get
Auth
Update Chat Settings
/services/ai/v1/chat/settings/update
Auth
Connections
Create Connection
/services/ai/v1/user/connections/create
Auth
List Connections
/services/ai/v1/user/connections/list
Auth
Test Connection
/services/ai/v1/user/connections/test
Auth
Update Connection
/services/ai/v1/user/connections/update
Auth
Toggle Connection Status
/services/ai/v1/user/connections/toggle-status
Auth
Delete Connection
/services/ai/v1/user/connections/delete
Auth
Conversations
List Conversations for this project. Visibility: config ai.conversations.visibility (project|owner)
/services/ai/v1/conversations/list
Auth
Get Conversation — any session on this project (teammate-shared)
/services/ai/v1/conversations/get
Auth
Rename Conversation
/services/ai/v1/conversations/rename
Auth
Sets a user-chosen title. A non-empty title overrides the title that would otherwise be derived from the first message / goal. Passing an empty/blank title clears the custom name and reverts to the derived one.
Fork Conversation
/services/ai/v1/conversations/fork
Auth
Creates a new same-project chat branched from this conversation (Claude/ChatGPT-style branch). Optional cut at a message id.
/services/ai/v1/conversations/fork-to-project
Auth
List projects the user can fork into (excludes current project when provided)
/services/ai/v1/conversations/fork-targets
Auth
Compact Conversation
/services/ai/v1/conversations/compact
Auth
Summarizes older turns into a checkpoint and keeps a recent verbatim tail for the model prompt. Full DB transcript is preserved for inspect.
Archive a conversation (soft-delete). Data is retained; the user can restore from Archived
/services/ai/v1/conversations/archive
Auth
Restore an archived conversation back to the active sidebar list
/services/ai/v1/conversations/restore
Auth
Permanently remove a chat from the user's account while retaining the row for audit
/services/ai/v1/conversations/unlink
Auth
The run stays archived; we copy user_id → original_user_id and clear user_id so it no longer appears in active or archived lists for that user.
/services/ai/v1/conversations/pick-greeting
Auth
/services/ai/v1/conversations/update-deployment-canvas
Auth
Archive a conversation (soft-delete). Data is retained; the user can restore from Archived
/services/ai/v1/conversations/delete
Auth
Credits
Balance = non-expiring prepaid EUR + this week's allotment (expires Sunday UTC). Spend order: weekly allotment first, then prepaid/top-up
/services/ai/v1/credits/balance
Auth
Get EUR usage rolled up for one user message turn (including cancelled turns)
/services/ai/v1/credits/turn-usage
Auth
McpProjectSettingsGet
/services/ai/v1/mcp/project-settings/get
Auth
McpProjectSettingsUpdate
/services/ai/v1/mcp/project-settings/update
Auth
Memory
Save Memory
/services/ai/v1/memory/save
Auth
Search Memory
/services/ai/v1/memory/search
Auth
List recent project memory facts
/services/ai/v1/memory/list
Auth
Get one project memory fact by id or key
/services/ai/v1/memory/get
Auth
Delete a project memory fact by id or key
/services/ai/v1/memory/delete
Auth
ProjectLesson
/services/ai/v1/lessons/list
Auth
/services/ai/v1/lessons/get
Auth
/services/ai/v1/lessons/create
Auth
/services/ai/v1/lessons/update
Auth
/services/ai/v1/lessons/deactivate
Auth
/services/ai/v1/lessons/activate
Auth
Providers
List Providers
/services/ai/v1/user/providers/list
Auth
Users can only view which providers are available. They cannot create, update, or delete providers.
Site assistant The owner's side of the site assistant (#1579): the setup
Site assistant setup
/services/ai/v1/site-assistant/settings/get
Auth
Save the site assistant setup
/services/ai/v1/site-assistant/settings/save
Auth
Read the outside websites again
/services/ai/v1/site-assistant/crawl
Auth
The websites the owner listed for the tracking snippet are read (public pages only, politely) into the assistant's knowledge. Queued; at most once every 10 minutes per project.
Conversations visitors had
/services/ai/v1/site-assistant/conversations/list
Auth
One conversation with its messages
/services/ai/v1/site-assistant/conversations/get
Auth
Delete a conversation (also on a visitor's request)
/services/ai/v1/site-assistant/conversations/delete
Auth
Turn a conversation into a lead
/services/ai/v1/site-assistant/conversations/to-lead
Auth
Turn a conversation into a ticket of the project's helpdesk, to answer the visitor by mail
/services/ai/v1/site-assistant/conversations/to-ticket
Auth
Thumbs on an answer, with the right answer for next time
/services/ai/v1/site-assistant/conversations/feedback
Auth
What the chat did: the action calls (the audit log)
/services/ai/v1/site-assistant/actions/calls
Auth
Newest first: action, kind, status, who confirmed, a plain summary (never raw parameters), duration and credits. `waiting: true` lists only the requests that wait for the owner's approval.
Approve or reject a request that waits for the owner
/services/ai/v1/site-assistant/actions/decide
Auth
The owner's test chat (the same visitor agent; leads and handoffs are only described)
/services/ai/v1/site-assistant/preview
Auth
Skill
/services/ai/v1/skills/list
Auth
/services/ai/v1/skills/skillify
Auth
/services/ai/v1/skills/load
Auth
/services/ai/v1/skills/unload
Auth
/services/ai/v1/skills/active
Auth
Full skill (incl. instructions) for the manager popup edit form. Project-owned skills only — global skills are read via /skills/list
/services/ai/v1/skills/get
Auth
/services/ai/v1/skills/update
Auth
/services/ai/v1/skills/delete
Auth
Tools
Preview Tool
/services/ai/v1/tools/preview
Auth
List Tools
/services/ai/v1/tools/list
Auth
Execute Tool
/services/ai/v1/tools/execute
Auth