API Reference
Acknowledge a policy change
Mark a single policy change as reviewed/acknowledged for the authenticated organization. Idempotent — acknowledging an already-acked change returns 200.
Requires Professional plan or higher and an API key with write or admin scope.
Authorization
bearerAuth AuthorizationBearer <token>
API keys are prefixed with vrt_live_ for production or vrt_test_ for testing.
Example: vrt_live_abc123xyz
In: header
Request Body
application/json
diff_id*integer
The policy diff ID to acknowledge
notes?string
Optional notes about the acknowledgment
Length
length <= 500Response Body
application/json
application/json
application/json
curl -X POST "https://verity.backworkai.com/api/v1/compliance/ack" \ -H "Content-Type: application/json" \ -d '{ "diff_id": 0 }'Empty
{
"success": true,
"data": {
"id": 0,
"acknowledged": true,
"already_acked": true
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid query parameters",
"hint": "Check the 'code' parameter format",
"details": {}
},
"meta": {
"request_id": "req_abc123"
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid query parameters",
"hint": "Check the 'code' parameter format",
"details": {}
},
"meta": {
"request_id": "req_abc123"
}
}Last updated on