Agent SwarmBudgets
Budgets API endpoints
Authorization
bearerAuth AuthorizationBearer <token>
API key via Authorization: Bearer <API_KEY>
In: header
Response Body
application/json
curl -X GET "http://localhost:3013/api/budgets"{
"budgets": [
{
"scope": "global",
"scopeId": "string",
"dailyBudgetUsd": 0,
"createdAt": 0,
"lastUpdatedAt": 0
}
]
}Authorization
bearerAuth AuthorizationBearer <token>
API key via Authorization: Bearer <API_KEY>
In: header
Path Parameters
scope*string
Value in
"global" | "agent"scopeId*string
Scope identifier — empty string for global, agent UUID otherwise
Length
length <= 255Response Body
curl -X DELETE "http://localhost:3013/api/budgets/global/string"Empty
Empty
Authorization
bearerAuth AuthorizationBearer <token>
API key via Authorization: Bearer <API_KEY>
In: header
Path Parameters
scope*string
Value in
"global" | "agent"scopeId*string
Scope identifier — empty string for global, agent UUID otherwise
Length
length <= 255Response Body
application/json
curl -X GET "http://localhost:3013/api/budgets/global/string"{
"scope": "global",
"scopeId": "string",
"dailyBudgetUsd": 0,
"createdAt": 0,
"lastUpdatedAt": 0
}Empty
Authorization
bearerAuth AuthorizationBearer <token>
API key via Authorization: Bearer <API_KEY>
In: header
Path Parameters
scope*string
Value in
"global" | "agent"scopeId*string
Scope identifier — empty string for global, agent UUID otherwise
Length
length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X PUT "http://localhost:3013/api/budgets/global/string" \ -H "Content-Type: application/json" \ -d '{ "dailyBudgetUsd": 0 }'{
"scope": "global",
"scopeId": "string",
"dailyBudgetUsd": 0,
"createdAt": 0,
"lastUpdatedAt": 0
}Empty
Authorization
bearerAuth AuthorizationBearer <token>
API key via Authorization: Bearer <API_KEY>
In: header
Query Parameters
limit?integer
Range
0 < value <= 500Response Body
application/json
curl -X GET "http://localhost:3013/api/budgets/refusals"{
"refusals": [
{
"taskId": "string",
"date": "string",
"agentId": "string",
"cause": "agent",
"agentSpendUsd": 0,
"agentBudgetUsd": 0,
"globalSpendUsd": 0,
"globalBudgetUsd": 0,
"followUpTaskId": "string",
"createdAt": 0
}
]
}