Skip to content
Verified

AI Workspace

Chats, AI agents, mini apps, contacts and sharing, over the API and over MCP.

The AI Agentic Workspace is the conversation engine behind AI Chats, the no-code AI agent builder, mini apps, contacts, account profiles and the sharing model that ties them together. Sixty of its methods are reachable with an account API key today, from archiving a chat to pulling the pending counts that badge the workspace nav, and the whole surface is available to an AI agent over MCP as well as plain REST.

What you can automate

  • Chats and mini apps: pin, favorite, archive, unarchive, rename and delete, the same six actions on each. AI agents: pin, favorite and archive only, plus generate_ai_agent_image for a fresh agent picture and set_agent_tool_consent to record whether an installed agent may use plugin tools that run in the platform. Unarchiving or deleting an agent, and renaming one, stay dashboard-only today.
  • Contacts: the full lifecycle, get_contacts, archive, pin, favorite, mark not-spam, enable deep research, plus add_contact_member and get_contact_members for a contact shared across a team.
  • Account profiles: create, update, archive and restore the profiles a workspace runs under.
  • Sharing: create_share, get_shares, confirm_share, decline_share, cancel_share, remove_share and update_share cover an invitation end to end.
  • Status and CLI auth: get_ai_workspace_pending_counts for the badge counts, and the CLI device-code flow, start_cli_auth, poll_cli_auth, approve_cli_auth, deny_cli_auth.

Worked example: archiving a chat

curl -s https://xuda.ai/cpi/archive_ai_chat \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","conversation_id":"YOUR_CONVERSATION_ID"}'
const res = await fetch('https://xuda.ai/cpi/archive_ai_chat', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', conversation_id: 'YOUR_CONVERSATION_ID' }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/archive_ai_chat',
    json={'api_key': 'YOUR_API_KEY', 'conversation_id': 'YOUR_CONVERSATION_ID'},
)

Sharing a contact

create_share takes an access_email, the share_item_id being shared, and an access_type, and returns a pending share that the recipient accepts with confirm_share or turns down with decline_share. get_shares reads them back by access_type, and update_share or remove_share manage one afterward.

Methods

Contacts and account profiles sit on the Account microservice (see Static Websites for its table), sharing sits on Team and sharing, and CLI device auth on Session and CLI auth. The interactive API reference lists both in full.