Initiate Verification Enrollment

POST 
/verification-actions-srv/setup/:method/initiation/:trackId

Starts verification enrollment during an in-login / suggest-verification flow.

Public: no bearer token. Context is {method} plus {trackId} from the prevalidation / enrollment UI (verified on demo: invalid payload returns 400, not 401).

Profile enrollment without trackId uses POST /verification-actions-srv/setup/{method}/initiation (user token with profile + cidaas:verification_write).

Request

Responses

200

OK

400

Bad request.

On errors, this verification-actions-srv endpoint returns success: false with a top-level string code (VER_*) and status (HTTP status).

Common code values:

code	Meaning
VER_0025	Invalid trackId path parameter
VER_0030	Invalid verification {method}
VER_0028	Verification method is not active
VER_0029	Verification method is already configured
VER_0005	Required request data is missing
VER_0004	Invalid or malformed request payload

For the full Verification Actions error catalogue, see Verification actions service error codes.