> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bossmode.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents API

> Manage capo agents, issue directives, and monitor execution status via the Agents API.

<Warning>🚧 Expanding soon — full Agents API documentation is in progress.</Warning>

## List active agents

```bash theme={null}
curl -sH "x-bossmode-token: $BOSSMODE_API_TOKEN" \
  https://bossmode.ing/api/pro/agents | jq
```

Response:

```json theme={null}
{
  "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

```bash theme={null}
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

```bash theme={null}
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.