Skip to content

AI Assistants

Assistants that answer for you, in private or in public.

Open AI Assistants
Checked against the dashboard on November 20, 2026

AI Assistants has six public methods. They act on an assistant that already exists: the favorite mark, the pin, the archive and its picture. Each acts for the account whose API key you use.

Making an assistant, changing its setup, its presets and its invitations, sending an invitation, reading its sessions and choosing a plan are done in the dashboard. They have no public method today.

Send a request to a method with your key:

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

res = requests.post(
    'https://xuda.ai/cpi/favorite_ai_agent',
    json={
        'api_key': 'YOUR_API_KEY',
        'agent_id': 'YOUR_ASSISTANT_ID',
    },
)

A good answer has code 1. A refused one has a negative code and says why in data. See Calling a method for the request forms.

The Assistant and Skill lists share these methods, so the field is called agent_id: it is the assistant's id. Every method also takes an optional workspace_id, to act in a workspace other than your own. The caller must own it.

Mark an assistant

  • favorite_ai_agent takes agent_id and marks the assistant as a favorite. This is Add to favorites in its card's More menu, and the Favorites choice in the page's Show menu lists it.
  • unfavorite_ai_agent takes the same field and takes the mark off.
  • pin_ai_agent takes agent_id and marks the assistant as pinned.
  • unpin_ai_agent takes the same field and takes the pin off.

Archive an assistant

archive_ai_agent takes agent_id and archives the assistant. It leaves the Active list and shows under Archived, and its conversations are archived with it. An optional conversation_id narrows the conversations that are archived to that one.

Only the assistant's maker can archive it. An assistant that was shared with you is refused with Operation not allowed. An assistant you have shared out to others is refused with active share found until the share ends.

Restoring an archived assistant and deleting it for good are dashboard actions: Unarchive and Delete in the card's menu, under the Archived status.

Draw a picture

generate_ai_agent_image takes agent_id and draws a new picture for an assistant you own, using the generator that runs when one is made. Use it when a card has no picture yet. It runs in the background as a job, and the new picture appears on the next load.

The picture's choices, such as country, gender, industry and your own words, the use of your own portrait and an uploaded picture are set in the dashboard's setup window.

What each plan changes

None of these methods is held by a plan. What a plan changes is what the assistant can do for visitors, which is not reachable from a method. See Plans and billing.

How is this guide?

Last updated on November 19, 2026