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