🚧 Expanding soon — full Approval Gates documentation is in progress.
What are approval gates?
Approval gates are pause points in the autonomous execution pipeline. When a directive or capo move hits a gate, execution halts until you explicitly approve or reject the action.
Gates are triggered by:
- A standing order with
requiresApproval: true
- A move that exceeds a threshold in an active standing order
- A first-time action type that BossMode hasn’t seen you approve before
- Manual escalation from the consigliere when it’s uncertain
Viewing the approval queue
curl -sH "x-bossmode-token: $BOSSMODE_API_TOKEN" \
https://bossmode.ing/api/pro/approvals | jq
Each approval item includes:
- The proposed action and its full content
- Which standing order triggered the gate
- The capo that generated the move
- Timestamp and expiration (approvals expire after 72h if not reviewed)
- Recommended action from the consigliere
Approving a move
curl -sX POST https://bossmode.ing/api/pro/approvals/{approval_id}/approve \
-H "x-bossmode-token: $BOSSMODE_API_TOKEN"
Optionally, approve with a modification:
curl -sX POST https://bossmode.ing/api/pro/approvals/{approval_id}/approve \
-H "x-bossmode-token: $BOSSMODE_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "modification": "Change the subject line to: The thing you asked about" }'
Rejecting with feedback
curl -sX POST https://bossmode.ing/api/pro/approvals/{approval_id}/reject \
-H "x-bossmode-token: $BOSSMODE_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "feedback": "Wrong tone. Match the warm, direct voice in buyer profile 1. Try again." }'
The consigliere reads your feedback and requeues the directive for another pass.
Notification configuration
Configure how you’re notified about pending approvals:
curl -sX PUT https://bossmode.ing/api/pro/settings/notifications \
-H "x-bossmode-token: $BOSSMODE_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"approvalNotifications": {
"email": true,
"emailAddress": "you@example.com",
"digest": "immediate",
"urgentEscalation": "immediate",
"standardQueue": "morning-report"
}
}'
Bulk approval
For reviewing multiple items at once (use with caution):
curl -sX POST https://bossmode.ing/api/pro/approvals/bulk-approve \
-H "x-bossmode-token: $BOSSMODE_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "ids": ["apr_abc", "apr_def", "apr_ghi"] }'
Building trust over time
As you approve types of moves repeatedly, BossMode learns your preferences and will surface those patterns in the morning brief. Over time, you can update your standing orders to permit those move types automatically — reducing approval queue volume as your trust in the consigliere grows.