Update agent

Update an AI agent's persona, model, and behavior.

PATCH/v1/ai-agents/{agentId}

Path parameters

ParameterTypeDescription

agentId

stringRequired

Identifier of the AI agent. Example: "agent_01".

Body parameters

application/json

ParameterTypeDescription

name

string

Display name for the AI agent. Length: 0-30 characters. Example: "Support assistant".

persona

string

Instructions that define the agent's role and behavior. Length: 0-10000 characters. Example: "Help customers resolve product and order questions clearly and politely.".

model

string

Stable model identifier. Some models require a paid plan. Allowed values: gpt-4o-mini, gpt-4.1-mini, gpt-4.1-nano, gpt-4.1, o4-mini, gpt-5, gpt-5-nano, gpt-5-mini, gpt-5.2, gpt-5.4-mini, gpt-5.4-nano, gpt-5.5, gemini-2.5-flash, gemini-2.5-pro, gemini-3.5-flash, gemini-3.1-pro, claude-4.5-sonnet, claude-4.5-opus, claude-4.5-haiku, claude-4.6-sonnet, claude-4.7-opus, claude-4.8-opus, llama-3.3, grok-beta, deepseek-chat, qwen-turbo, qwen-plus, qwen-max. Example: "gpt-5.4-mini".

temperature

number

Creativity level from 0 (more predictable) to 100 (more varied). Range: 0-100. Example: 0.

Responses

JSON

{
  "data": {
    "id": "agent_01",
    "name": "Support assistant",
    "persona": "Help customers with their questions.",
    "icon_url": "https://example.com/icon.png",
    "enabled": true,
    "channels": [
      "string"
    ],
    "model": "string",
    "temperature": 0.7,
    "personality": "string",
    "memory_enabled": true,
    "customer_support_enabled": true,
    "chat_history_limit": 10,
    "knowledge_topic_count": 10,
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-01-15T10:30:00Z"
  }
}