Skip to main content
POST
/
api
/
agents
Create Agent
curl --request POST \
  --url https://api.usehavoc.com/api/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "model": "anthropic/claude-sonnet-4-5",
  "templateId": "<string>"
}
'

Authorizations

​
Authorization
string
header
required

Clerk JWT Token — obtained from the Havoc frontend via Clerk authentication.

Body

application/json
​
name
string
required

Agent display name

​
model
string

Primary model identifier

Example:

"anthropic/claude-sonnet-4-5"

​
templateId
string

Optional template ID to base the agent on

Response

201

Agent created successfully