Skip to main content
POST
Create Agent

Authorizations

apikey
string
header
required

API Key (i.e. Rest API Key from the Dashboard).

Headers

chatApiVersion
string
default:v3.0

Chat API version. Defaults to v3.0.

Body

application/json
name
string
required

Name of the agent

icon
string

URL to the icon/avatar of the agent

description
string

Description of the agent

tools
string[]

Array of tool names available to this agent

apiTools
string[]

Array of API tool names available to this agent

mcpServers
string[]

Array of MCP server names available to this agent

instruction
string

Instructions for the agent behavior

metaData
object

Additional metadata for the agent

model
string
default:gpt-4o-mini

AI model to use for this agent

modelMetaData
object

Configuration metadata for the AI model

isActive
boolean
default:true

Is the agent active?

Response

200 - application/json

Agent created successfully

agent
object