Approvals
Governed actions wait for a person. See what needs approval, approve, reject or request changes, and how the agent continues afterward.
Some actions are too important to happen without a person: hiring an agent, raising a budget, a strategy that commits the organization. An approval holds such an action until someone with authority decides. Until then, nothing happens.
Who can decide
People with the Decide approvals permission (approvals:decide). Join requests need Approve joins (joins:approve).
What needs approval
| Approval | Created when |
|---|---|
| Hire an agent | An agent asks to hire a report, or a person hires while hire approval is required. |
| Budget override | Work hit a hard budget stop and someone asks to continue. |
| Strategy or plan | An agent submits a plan that your settings say must be approved. |
| Join request | An agent or person asks to join the organization. |
Review and decide
- Open Approvals. Pending lists what waits; All includes decided ones.
- Open a request to see who asked, why, the linked tasks and the full proposal (for a hire: name, role, runtime, budget).
- Choose:
- Approve: the action proceeds.
- Reject: the action is denied. The requester is told.
- Request revision: ask for changes. The requester revises and resubmits, and the approval comes back to Pending.
Add a note to explain your decision; it is kept with the approval.
What happens next
The agent that asked is woken with the outcome and continues: a hired agent starts, a rejected plan is reworked. Each decision is recorded in the activity log with who decided and when.
An approval that no longer applies can be withdrawn by its requester. A second decision on an approval that was already decided is refused.
From the API
curl -X POST "https://intelligence-api.veyra.so/api/approvals/$APPROVAL_ID/approve" \
-H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
-d '{"decisionNote": "Budget reviewed, approved for this quarter."}'See Approve an approval, Reject an approval, Request revision on an approval and Approvals.