Access Certification

End campaign early

Closes an active campaign run before its scheduled review window ends.

Use remediationMode in the request body to control what happens to pending remediations:

  • execute_remediation — Run remediation for all revoked identities according to policy
  • cancel_remediation — Close without executing pending remediations

Returns 409 Conflict if the run is not active.

Required permission: accesscertification (Full Access)

post/access-certification/campaign-runs/{runId}/end-early

Request

Path parameters

runIdstring required

Campaign run public identifier (hex-encoded BSON ObjectID stored as object_id).

Request body

remediationMode'execute_remediation' | 'cancel_remediation' required

Whether to execute or cancel pending remediations when ending a campaign early

Response

Campaign run closed early

campaignIdstring required
runIdstring required
status'closed' required
closedAtstring date-time required
remediationStatus'in_progress' | 'scheduled' | 'completed' | 'canceled'
auditReportStatus'generating' | 'exports_ready'

Initial audit artifact status after close

Changes

No recorded changes to this operation across all 1 revision of this API.