Skip to main content
POST
Create agent

Authorizations

Authorization
string
header
required

JWT authentication token

Headers

x-company-id
string

Target company identifier. Required only for global API keys (type=global). Ignored for company API keys and human users.

Body

application/json
name
string
required

The agent's name on the platform.

Minimum string length: 1
prompts
object
required

Prompts that define the agent's identity and behavior.

agent_flow
string
required

ID of the agent's execution flow, among those enabled for the company.

Minimum string length: 1
general_config
object

General settings of the agent

model_config
object
specialist_config
object

Specialist settings (qualification and ICP)

avatar_color
string

The agent's avatar color.

avatar_initials
string

Initials shown on the avatar (up to 2 characters).

Maximum string length: 2
personality_presets
enum<string>[]

Ready-made personality profiles (up to 3).

Maximum array length: 3
Available options:
FRIENDLY,
DIDACTIC,
CURIOUS,
FORMAL,
PLAYFUL,
PERSUASIVE

Response

201 - application/json
_id
object
required
name
string
required
agent_flow
object
required
prompts
object
required
company
object
required
model_config
object
required
status
enum<string>
required
Available options:
ACTIVE,
DRAFT,
INACTIVE,
DELETED
general_config
object
specialist_config
object
knowledge_base
object[]
avatar_color
string
avatar_initials
string
personality_presets
enum<string>[]
Available options:
FRIENDLY,
DIDACTIC,
CURIOUS,
FORMAL,
PLAYFUL,
PERSUASIVE
steps
object[]