Revoke a Document Signer

Revokes an existing Document Signer, making it unusable for signing new mDocs.

If the verifier checks the CRL referenced in the IACA certificate, it must treat revoked Document Signers and any mDocs they signed as untrusted.

Only available in implementations using managed IACAs. When using unmanaged (external) IACAs, you must revoke the Document Signer certificate directly with the CA that issued it.

Analytics Events

MOBILE_CREDENTIAL_DOCUMENT_SIGNER_REVOKE_STARTMOBILE_CREDENTIAL_DOCUMENT_SIGNER_REVOKE_SUCCESSMOBILE_CREDENTIAL_DOCUMENT_SIGNER_REVOKE_FAIL

Roles

adminissuer

POST/v2/credentials/mobile/document-signers/{documentSignerId}/revoke

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

documentSignerIdstring

Document Signer identifier

Formatuuid

Request Body

Empty Object

Response Body

curl -X POST "https://example.vii.au01.mattr.global/v2/credentials/mobile/document-signers/497f6eca-6276-4993-bfeb-53cbbbba6f08/revoke" \
  -H "Content-Type: application/json" \
  -d '{}'

curl -X POST "https://example.vii.au01.mattr.global/v2/credentials/mobile/document-signers/497f6eca-6276-4993-bfeb-53cbbbba6f08/revoke" \  -H "Content-Type: application/json" \  -d '{}'

{
  "revoked": true,
  "revocationDate": "2025-10-31T23:59:59Z"
}

{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}

{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}

{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}