KYC

Delete a KYC level

DELETE/kyc-levels/{id}
kyc:writedelete_kyc_levelDestructiveIdempotent

Soft-deletes the level and returns 204. The level stops appearing in lists and can no longer be fetched, but its row is kept. It can't be undone through the API and has no dry run; add the level again with POST /kyc-levels. A repeat call returns 404. Emits kyc_level.deleted and sends no email. A level that a workflow KYC check step still uses is deleted too.

Path parameters

  • idstring (uuid)Required#

    The KYC level's id.

Responses

204

The level was deleted.

401

Authentication failed. error.code is one of invalid_token, expired, revoked.

Error
403

Authorization failed. error.code is one of org_disabled, ip_blocked, missing_scope, scope_disabled, user_disabled.

Error
404

Resource not found (error.code = not_found).

Error
409

The request conflicts with existing state (error.code = conflict), e.g. a compliance flow with the requested name already exists.

Error
422

The request can't be processed (HTTP 422): validation_failed with one ErrorDetail per problem, or a code documented on the operation.

Error
429

Rate limit exceeded (error.code = rate_limited).

Error

Examples

curl -X DELETE https://your-org-domain/kong/core/api/v2/kyc-levels/{id}\
  -H "Authorization: Bearer $HELM_API_KEY"\
  -H "Content-Type: application/json"