Skip to main content
POST
/
api
/
agents
Create agent
curl --request POST \
  --url https://api.agentixx.io/api/agents \
  --header 'Content-Type: application/json' \
  --header 'x-tenant-id: <api-key>' \
  --cookie better-auth.session_token= \
  --data '
{
  "name": "Support Agent",
  "role": "customer_support",
  "model": "gpt-4.1-mini"
}
'
{}

Authorizations

better-auth.session_token
string
cookie
required

Session cookie set by Better Auth on sign-in.

x-tenant-id
string
header
required

Tenant/workspace UUID. Required on all /api/* endpoints.

Body

application/json

Create a new AI agent

name
string
required
Minimum string length: 1
role
string
model
string
instructions
string | null
handoffDescription
string | null
tone
string
answerLength
string

Response

Agent created

{key}
any