Approve a pending agent action (and resume its run)
Approve a require_approval action raised by one of your headless runs.
The deferred tool executes with the ORIGINAL requester’s scope, its
result is appended to the run’s conversation, and once ALL of the run’s
approvals are terminal the run resumes (full continuation, bounded by the
agent’s maxIterations). Requires the agents:approve scope and ownership
of the owning run. Consequential — writes an audit entry.
Authorizations
API key or personal access token (NEX-1042). Send as
Authorization: Bearer <token>. Token format:
nex_live_…— live API key (server-to-server)nex_test_…— sandbox API keynex_pat_…— personal access token (acts as the issuing user)
Authorization is decided by the key's scopes array, not the
owning user's RBAC role. See POST /api/api-keys to mint a key.
Path Parameters
Body
2000Response
Approval resolved
Result of resolving (approving/rejecting) a pending agent action.
resolved approve, reject The headless run this approval belongs to.
True when the owning run was re-driven (all its approvals now terminal).
True when the owning run was terminated as rejected.
Outcome of executing the deferred tool (approve only).

