Skip to main content
POST
/
agents
Create agent
curl --request POST \
  --url https://api.trymaitai.ai/api/v1/agents \
  --header 'Content-Type: application/json' \
  --header 'X-Maitai-Api-Key: <api-key>' \
  --data '
{
  "application_id": 42,
  "agent_name": "Onboarding Agent",
  "description": "Guides new users through account setup"
}
'
{
  "data": {
    "id": 101,
    "agent_name": "Onboarding Agent",
    "description": "Guides new users through account setup",
    "application_id": 42,
    "status": "ENABLED"
  }
}

Authorizations

X-Maitai-Api-Key
string
header
required

Your Maitai API key from the Portal.

Body

application/json
application_id
integer
required
agent_name
string
required
description
string
base_url
string
meta
object

Response

201 - application/json

Create agent.

data
object

An agent orchestrates actions, sub-agents, and routing to handle complex multi-step tasks.