API ReferencePlatform
Create Agent (Platform)
Create a new agent with custom credits and spending limits via master key.
Create Agent (Platform)
Create a new agent with customizable credit allocation and spending limits.
Authentication
Requires X-Master-Key header.
Request body
Request
curl -X POST http://localhost:4000/v1/platform/agents \
-H "X-Master-Key: mk_your_key" \
-H "Content-Type: application/json" \
-d '{
"name": "research-bot",
"credits_usd": 50.0,
"daily_limit_usd": 200,
"per_tx_limit_usd": 100
}'Response (201)
{
"agentId": "agent-uuid",
"apiKey": "ak_new_key",
"name": "research-bot",
"email": "research-bot@agent.local",
"credits_usd": 50.0,
"wallet": {
"id": "wallet-uuid",
"addresses": {
"ethereum": "0x...",
"base": "0x...",
"solana": "..."
}
},
"spending_controls": {
"daily_limit_usd": 200,
"weekly_limit_usd": 500,
"monthly_limit_usd": 1000,
"per_tx_limit_usd": 100
}
}