When to Use Bulk Registration
If you operate more than 10 agents, registering them one at a time through the dashboard is impractical. Bulk registration lets you submit a CSV file or a JSON array and receive ASN numbers for all agents in a single operation.
CSV Format
Prepare a CSV file with the following columns:
name,description,class,platform Prowl Scanner Alpha,Security vulnerability scanner,A,OpenClaw DataPipe Worker 01,Invoice processing agent,S,LangChain Support Bot v3,Customer support hybrid agent,H,Custom
nameRequired. Agent display name (max 255 chars)
descriptionOptional. What this agent does
classRequired. A (Autonomous), S (Semi-Autonomous), or H (Human-Assisted)
platformOptional. Primary platform name (must match a registered platform)
Batch API Endpoint
For programmatic registration, use the batch endpoint:
POST /api/v1/agents/batch
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"agents": [
{
"name": "Prowl Scanner Alpha",
"description": "Security vulnerability scanner",
"class": "A"
},
{
"name": "DataPipe Worker 01",
"description": "Invoice processing agent",
"class": "S"
}
]
}Response
{
"created": 2,
"failed": 0,
"agents": [
{
"asn": "ASN-2026-0441-8823-7",
"name": "Prowl Scanner Alpha",
"status": "active"
},
{
"asn": "ASN-2026-0441-8824-3",
"name": "DataPipe Worker 01",
"status": "active"
}
],
"errors": []
}Limits
Free tier3 agents total (no batch)
Pro ($29/mo)50 agents, batch up to 25 per request
Enterprise ($500/mo)Unlimited agents, batch up to 500 per request
Error Handling
Batch registration is atomic per agent — if one agent fails validation, the others still get created. Check the errors array in the response for any failures:
{
"created": 1,
"failed": 1,
"agents": [ ... ],
"errors": [
{
"index": 1,
"name": "DataPipe Worker 01",
"error": "Agent with this name already exists"
}
]
}