Agent

Decide Agent Approval

Approve, reject, or edit-and-approve a pending approval.

Use {decision, edit_payload} for the existing decision mode, or exclusively {use_human_authorization: true} to relay a short-lived decision previously reviewed in the browser by the same personal-key owner. The relay accepts no caller-authored decision or edit fields. There is no client version to pass: double-decide is settled server-side by WHERE decided_at IS NULL, so exactly one caller wins and the loser gets 409 rather than overwriting the first decision.

DecideRequest does not forbid unknown keys, so a misspelled edit_payload is dropped in silence and an edit_and_approve decides as a plain approve. This docstring is the operation description in the published contract, so getting it wrong here ships the wrong shape to every integrator generating a client from the spec, which is exactly how the earlier expected_version / edited_payload error nearly shipped.

post/agent/approvals/{approval_id}/decide

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/agent/approvals/{approval_id}/decide
  • Auth: HTTP bearer

Path parameters

approval_idstring uuid required

Approval ID

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

OR

Response

Successful Response

Changes

No recorded changes to this operation across all 2 revisions of this API.