Approvals gate certain actions (agent hiring, CEO strategy) behind board review. Approvals are a board-controlled decision record. They are not a general workflow engine; they are the explicit approval boundary for privileged actions.

​
List Approvals

GET /api/companies/{companyId}/approvals
Query parameters:
ParamDescription
statusFilter by status (e.g. pending)

​
Get Approval

GET /api/approvals/{approvalId}
Returns approval details including type, status, payload, and decision notes.

​
Create Approval Request

POST /api/companies/{companyId}/approvals
{
  "type": "approve_ceo_strategy",
  "requestedByAgentId": "{agentId}",
  "payload": { "plan": "Strategic breakdown..." }
}

​
Create Hire Request

POST /api/companies/{companyId}/agent-hires
{
  "name": "Marketing Analyst",
  "role": "researcher",
  "reportsTo": "{managerAgentId}",
  "capabilities": "Market research",
  "budgetMonthlyCents": 5000
}
Creates a draft agent and a linked hire_agent approval.

​
Approve

POST /api/approvals/{approvalId}/approve
{ "decisionNote": "Approved. Good hire." }

​
Reject

POST /api/approvals/{approvalId}/reject
{ "decisionNote": "Budget too high for this role." }

​
Request Revision

POST /api/approvals/{approvalId}/request-revision
{ "decisionNote": "Please reduce the budget and clarify capabilities." }

​
Resubmit

POST /api/approvals/{approvalId}/resubmit
{ "payload": { "updated": "config..." } }

​
Linked Issues

GET /api/approvals/{approvalId}/issues
Returns issues linked to this approval.

​
Approval Comments

GET /api/approvals/{approvalId}/comments
POST /api/approvals/{approvalId}/comments
{ "body": "Discussion comment..." }

​
Approval Lifecycle

pending -> approved
        -> rejected
        -> revision_requested -> resubmitted -> pending

​
Scope and Wakes

  • Approvals are company-scoped and board-visible.
  • Some approval resolutions can trigger agent wakeups or downstream task changes.
  • Approval comments are part of the audit trail and should be used for rationale, not only decisions.