Reject a pending agent action (and terminate its run)
Reject a require_approval action raised by one of your headless runs.
The deferred tool is NOT executed; a denial note is appended to the run’s
conversation and the owning run is terminated with status: rejected.
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).

