JUjumpcloud
Access Certification

Activate campaign

Starts a campaign run immediately. The service identifies all identities in scope, creates a review item for each, and captures a frozen snapshot of their directory attributes at activation time.

Activation is asynchronous — the response may return status: activating while review items are being created. Poll GET /access-certification/campaigns/{campaignId} or GET /access-certification/campaign-runs/{runId} until materializationStatus is complete.

Returns 409 Conflict when Access Certification is disabled (featureEnabled is false in access certification settings). Scheduled auto-start is also blocked while disabled.

Required permission: accesscertification (Full Access)

post/api/v2/access-certification/campaigns/{campaignId}/activate

Request

Path parameters

campaignIdstring required

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

Response

Campaign already active with review items materialized (idempotent)

campaignIdstring required
runIdstring required
status'active' | 'activating' required
reviewItemsMaterializedinteger required

Number of review items created when the campaign was activated

materializationStatus'in_progress' | 'complete' | 'failed'

Cohort materialization progress while review items are created at activate

reviewWindowStartstring date-time
reviewWindowEndstring date-time

Changes

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