🚧 Expanding soon — full Agents API documentation is in progress.
List active agents
curl -sH "x-bossmode-token: $BOSSMODE_API_TOKEN" \
https://bossmode.ing/api/pro/agents | jq
{
"agents": [
{
"id": "capo_marketing",
"role": "capo_marketing",
"status": "active",
"pendingDirectives": 1,
"completedToday": 3,
"lastExecutedAt": "2026-04-13T08:45:00Z"
},
{
"id": "capo_revenue",
"role": "capo_revenue",
"status": "awaiting-approval",
"pendingDirectives": 0,
"completedToday": 1,
"lastExecutedAt": "2026-04-12T16:20:00Z"
}
]
}
Issue a directive
curl -sX POST https://bossmode.ing/api/pro/directives \
-H "x-bossmode-token: $BOSSMODE_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"directive": "Identify the top 5 leads who haven't engaged in 14 days and draft a re-engagement sequence.",
"capo": "capo_marketing",
"priority": "medium",
"requiresApproval": true,
"context": {
"segment": "warm-leads-14-day-stale"
}
}'
Directive fields
| Field | Type | Required | Description |
|---|
directive | string | Yes | Plain English instruction for the capo |
capo | string | Yes | Target capo role |
priority | string | No | "high", "medium", "low" (default: "medium") |
requiresApproval | boolean | No | Whether output queues for review (default: true) |
context | object | No | Additional context passed to the capo |
deadline | ISO 8601 | No | When this directive expires if not executed |
Get directive status
curl -sH "x-bossmode-token: $BOSSMODE_API_TOKEN" \
https://bossmode.ing/api/pro/directives/{directive_id} | jq
Capo roles
| Role | Domain |
|---|
capo_marketing | Audience, content, traffic, nurture |
capo_revenue | Deals, pricing, offers, pipeline |
capo_ops | Delivery, logistics, execution |
capo_product | Build backlog, features, release |
ceo | Strategic brief, morning report |
Agent context
Every capo execution receives the full operational context automatically: buyer profiles, standing orders, recent signals, and Guardian state. You don’t need to pass this manually.
