> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sphyre.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /api/issuer/:did/credentials/:credential_id/revoke

> Revoke an issued credential

```http theme={null}
POST /api/issuer/did:alyra:issuer.../credentials/aly:uuid/revoke HTTP/1.1
Authorization: Bearer <jwt>
```

## Path Parameters

| Parameter       | Type   | Description                      |
| --------------- | ------ | -------------------------------- |
| `did`           | string | Issuer DID.                      |
| `credential_id` | string | Credential identifier to revoke. |

## Response

`200 OK`

```json theme={null}
{
  "success": true,
  "message": "Credential revoked successfully",
  "credential": {
    "id": "aly:uuid",
    "issuer_did": "did:alyra:issuer...",
    "owner_did": "did:alyra:holder...",
    "status": "revoked",
    "revocation_blockchain_tx": "0x..."
  }
}
```

Revocation updates the MongoDB credential record and attempts to record revocation on-chain when the blockchain client is configured.
