Skip to content

Approval.approve

POST /{namespace}/approvals/{approval}/approve

Approve allows the pending Action an Approval holds, and that Action runs.

Mode
do
Event
Approval.approved

Inputs

InputTypeRequiredDescription
approvalApprovalrequiredThe open Approval.
notetextWhy it is approved.

Outputs

OutputTypeRequiredDescription
approvalApprovalrequiredThe approved Approval.

Effects

  • Emits Approval.approved.
  • Performed by the Founder.
  • Guards run first, then Evaluators where a Policy enables them, and a Human approves only above the stakes threshold.
  • Counts a chat press only from an account linked to a Human who holds the Permission for the Action’s scope.
  • Records the first valid answer; the chat card updates in place, and a later press returns that verdict.
  • Asks the approver to sign in first when a one-way Action is at or above the stakes threshold.
  • Records the answer as an Action via chat, with the message it came from.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.Approval.approve
The record is not in a state that allows this Verb, so the call is refused.refusedRead the record, run the Verb that moves it to an allowed state, then retry.Approval.approve

When it waits

GateDefault
Decision classLow: two-way, nothing at stake
Delay windowNone: it runs once review passes.
LimitThe call Limit of the Permission it runs under.
Over the LimitIt waits pending for an Approval from the Founder. Approved, it runs; refused, it ends refused with limit-exceeded; unanswered by its deadline, it ends canceled.