Managed agents

Resolve an independently verified unknown effect

Compare-and-swap requires the current unknown step revision and an evidence digest. completed requires the verified JSON result. no_effect authorizes one further bounded attempt. cancelled stops the run. Original unknown attempts remain retained.

post/v1/agents/{id}/runs/{run_id}/resolve

Request

  • Base URL
    / (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    HTTP bearer

Path parameters

idstring required
run_idstring required

Request body

step_idstring required
expected_revisioninteger required
decision'completed' | 'no_effect' | 'cancelled' required
reasonstring required
evidence_digeststring required
resultstring byte

Base64 of exact UTF-8 json-v1 bytes, at most 256 KiB decoded. Objects use sorted keys and compact encoding. Nonfinite numbers, duplicate keys and non-JSON values are refused.

Response

Success

decisionstring required
step_idstring required
external_keystring required
revisioninteger required
resultstring byte

Base64 of exact UTF-8 json-v1 bytes, at most 256 KiB decoded. Objects use sorted keys and compact encoding. Nonfinite numbers, duplicate keys and non-JSON values are refused.

Changes

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