Sign in
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

Changes

Changed in 2 of the 4 revisions of this API.5

  • 33e4ba4936ad2See the full diff
    • ○

      added the required property share_enabled to the response with the 200 status

      response-required-property-added

    • ○

      added the required property share_updated_at to the response with the 200 status

      response-required-property-added

    This revision also has 8 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • c9eb29ec9a1b3See the full diff
    • ○

      the execution_mode request property default value changed from react to balanced

      request-property-default-value-changed

    • ○

      added the required property allowed_domains to the response with the 200 status

      response-required-property-added

    • ○

      added the required property widget_enabled to the response with the 200 status

      response-required-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog