v4

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-13216144508.7 KB
agents

Create Agent

Create a new custom agent.

post/api/agents

Request body

namestring required

Agent name

descriptionstring nullable

Agent description

instructionsstring nullable

System instructions/prompt

execution_modestring nullable

Execution mode: flash, balanced, think, or auto

modelsobject nullable

Model config: {general, small_fast, visual, compact}

knowledge_basesstring[]

Knowledge base names

skillsstring[]

Skill names

tool_categoriesstring[]

Tool category names

suggested_promptsstring[]

Suggested prompt examples for users

logo_base64string nullable

Logo image as base64 data URL

Response

Successful Response

idinteger required
user_idinteger required
namestring required
descriptionstring nullable required
instructionsstring nullable required
execution_modestring required
modelsobject nullable required
knowledge_basesstring[] required
skillsstring[] required
tool_categoriesstring[] required
suggested_promptsstring[] required
logo_urlstring nullable required
statusstring required
published_atstring nullable required
created_atstring required
updated_atstring required
widget_enabledboolean required
allowed_domainsstring[] required
share_enabledboolean required
share_updated_atstring nullable required