Approvals

Governed actions wait for a person. See what needs approval, approve, reject or request changes, and how the agent continues afterward.

Veyra Docs TeamUpdated 1 min readVersion 3 · History

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

  1. Open Approvals. Pending lists what waits; All includes decided ones.
  2. Open a request to see who asked, why, the linked tasks and the full proposal (for a hire: name, role, runtime, budget).
  3. 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
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.

ApprovalsGovernance