Verify and publish remediation evidence

POST/v1/security/remediations/{remediationId}/complete

Internal fenced worker endpoint. GitHub is read directly before a pull request is accepted as published.

How to call this endpoint

Every ACP API request uses bearer authentication. The examples here show the actual request path, auth header, and body shape that the platform expects.

Path, query, and header parameters

These parameters control which ACP object the endpoint acts on and how the request is processed.

Path parameters
NameLocationTypeRequiredDescription
remediationIdpathstringYes
Query parameters
None.
Header parameters
NameLocationTypeRequiredDescription
X-Computer-Agents-OrganizationheaderstringNoActive organization context. If omitted, the authenticated user's personal organization is used.

Body schema

Content type: application/json · Required

FieldTypeRequiredDescription
dispatchIdstringYes
threadIdstringYesThread ID.
outputstringYesWorker response containing the fenced security_remediation_json evidence block.

What the API returns

Each response code below includes the documented payload shape for the ACP API.

200GitHub-verified remediationapplication/json
FieldTypeRequiredDescription
idstringYesUnique identifier.
repositoryIdstringYes
findingIdstringNo
findingIdsstring[]Yes
runIdstringNo
statusproposed | validating | waiting_approval | approved | published | rejected | failed | cancelledYesCurrent lifecycle status.
lifecyclequeued | generating | agent_running | pull_request_open | pull_request_closed | merged | verifying | fixed | deployed | verification_failed | failed | cancelledYes
patchDigeststringYes
validationobjectYes
approvedByUserIdstringNo
approvedAtstringNo
branchNamestringNo
pullRequestIdstringNo
pullRequestUrlstringNo
workerThreadIdstringNo
sourceShastringNo
metadataobjectYesFree-form metadata object.
createdAtstringYesISO 8601 timestamp.
updatedAtstringYesISO 8601 timestamp.
404Resource not foundapplication/json
FieldTypeRequiredDescription
errorstringNo
422The worker evidence or GitHub pull request violated remediation policy
None.
Verify and publish remediation evidence
Loading...
Response 200
Loading...
See the ACP quickstart and SDK flow