Agents

Decide Agent Operator Approval

Approve or reject a fix this operator proposed.

approved RUNS THE FIX: the operator executes its proposed remediation against your data, then records the result. rejected records the decision and runs nothing. Needs OPERATOR_MANAGE, the same governance gate as the trust dials, because this authorises execution.

A task that is not an open approval for this operator is a 404.

post/agent/operators/{operator}/approvals/{task_id}/decide

Request

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

Path parameters

operatorstring required
task_idstring required

The approval task id.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

resolution'approved' | 'rejected' required

approved EXECUTES the finding's proposed fix against your data; rejected records the decision and executes nothing.

paramsobject nullable

Values a fix needs that the operator could not decide for you, e.g. {"target_user": "<user id>"}. Omit for a fully-specified fix. A value the fix refuses is a 400 naming the field, and the task stays open.

Response

Successful Response

dataOperatorPayload required

An open envelope for one operator answer.

Open because an operator's health snapshot, scorecard and catalog are per-operator documents whose shape follows what that operator monitors - the revenue operator reports different checks from the deliverability one, and both grow. On an OVERSIGHT surface a dropped field reads as "nothing to worry about" rather than "we did not tell you", which is the failure mode worth designing against.

Changes

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