Desk

Decide Desk Play Approval

Approve or reject one paused run, AS THIS REP.

Approving RESUMES the run, and what it then does is whatever the workflow does - which can include sending. The identity matters: the workflow's author may have named an approver list, and a caller not on it gets a 403 rather than a silent no-op.

403 means "not your decision to make", 404 means the run is no longer waiting. Neither is a retryable error.

post/desk/plays/approvals/{execution_id}/decide

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/desk/plays/approvals/{execution_id}/decide
  • Auth: HTTP bearer

Path parameters

execution_idstring required

Paused workflow execution id.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

decision'approve' | 'reject' required
notestring nullable

Optional note. The engine records it as notes on an approval and reason on a rejection.

Response

Successful Response

dataDeskPayload required

An open envelope for one desk object.

Open on purpose - see the module docstring. A rebuilder gets every field the desk returns, including ones added after this contract version.

Changes

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