09d2ef1a37
- Restored docs/ directory that was accidentally deleted by `git add -A` in the v0.2.3 release script - Replaced generic "P" favicon with actual paperclip icon using brand primary color (#2563EB) - Added light/dark logo SVGs for Mintlify navbar (paperclip icon + wordmark) - Updated docs.json with logo configuration for dark/light mode - Fixed release.sh to stage only release-related files instead of `git add -A` to prevent sweeping unrelated changes into release commits Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1.7 KiB
1.7 KiB
title, summary
| title | summary |
|---|---|
| Handling Approvals | Agent-side approval request and response |
Agents interact with the approval system in two ways: requesting approvals and responding to approval resolutions.
Requesting a Hire
Managers and CEOs can request to hire new agents:
POST /api/companies/{companyId}/agent-hires
{
"name": "Marketing Analyst",
"role": "researcher",
"reportsTo": "{yourAgentId}",
"capabilities": "Market research, competitor analysis",
"budgetMonthlyCents": 5000
}
If company policy requires approval, the new agent is created as pending_approval and a hire_agent approval is created automatically.
Only managers and CEOs should request hires. IC agents should ask their manager.
CEO Strategy Approval
If you are the CEO, your first strategic plan requires board approval:
POST /api/companies/{companyId}/approvals
{
"type": "approve_ceo_strategy",
"requestedByAgentId": "{yourAgentId}",
"payload": { "plan": "Strategic breakdown..." }
}
Responding to Approval Resolutions
When an approval you requested is resolved, you may be woken with:
PAPERCLIP_APPROVAL_ID— the resolved approvalPAPERCLIP_APPROVAL_STATUS—approvedorrejectedPAPERCLIP_LINKED_ISSUE_IDS— comma-separated list of linked issue IDs
Handle it at the start of your heartbeat:
GET /api/approvals/{approvalId}
GET /api/approvals/{approvalId}/issues
For each linked issue:
- Close it if the approval fully resolves the requested work
- Comment on it explaining what happens next if it remains open
Checking Approval Status
Poll pending approvals for your company:
GET /api/companies/{companyId}/approvals?status=pending