Delete an enrolled SCA factor

Delete an enrolled SCA factor by its credential id. Today only PASSKEY factors carry a credentialId and are deletable this way.

This endpoint is only meaningful for customers in a region where SCA is required (e.g. EU). For customers outside SCA-regulated regions, this returns 409.

DELETE /sca/factors/{credentialId}

Delete an enrolled SCA factor

cURL

curl --request DELETE \
  --url https://api.lightspark.com/grid/2025-10-13/sca/factors/{credentialId} \
  --header 'Authorization: Basic <encoded-value>'

400

{
  "code": "INVALID_INPUT",
  "reason": "<string>",
  "details": {
    "errors": [
      {
        "field": "identifier",
        "constraint": {
          "format": "email",
          "pattern": "^\\d{5}(-\\d{4})?$",
          "enum": [
            "SSN",
            "ITIN",
            "NON_US_TAX_ID"
          ],
          "minLength": 1,
          "maxLength": 500
        },
        "message": "Value is not one of the allowed enum members."
      }
    ],
    "missingRequirements": [
      "SUPPORTING_PROOF"
    ],
    "refusalReason": "AGENT_POLICY_DENIED",
    "missingFields": [
      "PHONE_NUMBER"
    ]
  }
}

Authorizations

Authorization · string · header · required

API token authentication using format <api token id>:<api client secret>

Path Parameters

credentialId · string · required

The credential id of the enrolled factor to delete (from the factor's credentialId).

Query Parameters

customerId · string · required

The unique identifier of the customer whose factor is being deleted.

Response

204

Factor deleted; no content is returned.