---
title: "Revoke a certificate"
method: POST
path: "/api/v1/certificates/{id}/revoke"
tags: ["Certificates"]
---

# Revoke a certificate

`POST /api/v1/certificates/{id}/revoke`

## Request

- Base URL: `http://localhost:5000`
- URL: `http://localhost:5000/api/v1/certificates/{id}/revoke`
- Auth: HTTP bearer

Revokes a certificate. Cannot revoke an already revoked certificate.

## Path parameters

- `id` string, required

## Response `200`

Certificate revoked

- object
  - `success` boolean
  - `data` object
    - `certificate` Certificate
      - `_id` string
      - `certificateId` string
      - `userId` string
      - `domains` string[]
      - `type` 'single' | 'wildcard' | 'multi-domain'
      - `status` 'pending' | 'validating' | 'active' | 'expired' | 'revoked' | 'failed'
      - `validationMethod` 'dns' | 'http' | 'email'
      - `keyType` 'rsa' | 'ecdsa'
      - `keySize` 256 | 384 | 2048 | 4096
      - `certificate` object
        - `pem` string, nullable
        - `chain` string, nullable
        - `fullchain` string, nullable
      - `csr` string, nullable
      - `serialNumber` string, nullable
      - `fingerprint` object
        - `sha1` string, nullable
        - `sha256` string, nullable
      - `issuer` object
        - `commonName` string
        - `organization` string
        - `country` string
      - `subject` object
        - `commonName` string
        - `organization` string, nullable
        - `organizationalUnit` string, nullable
        - `country` string, nullable
        - `state` string, nullable
        - `locality` string, nullable
      - `validFrom` string, date-time, nullable
      - `validTo` string, date-time, nullable
      - `expiresAt` string, date-time
      - `autoRenew` boolean
      - `renewalAttempts` integer
      - `lastRenewalAttempt` string, date-time, nullable
      - `nextRenewalDate` string, date-time
      - `validation` object
        - `records` object[]
          - `domain` string
          - `method` 'dns' | 'http' | 'email'
          - `status` 'pending' | 'valid' | 'invalid' | 'expired'
          - `token` string
          - `keyAuthorization` string
          - `validatedAt` string, date-time, nullable
          - `expiresAt` string, date-time
        - `completedAt` string, date-time, nullable
      - `monitoring` object
        - `enabled` boolean
        - `lastCheck` string, date-time, nullable
        - `nextCheck` string, date-time
      - `metadata` object
        - `tags` string[]
        - `notes` string, nullable
        - `environment` 'development' | 'staging' | 'production'
      - `isActive` boolean
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
  - `message` string

## Other responses

- `400`: Certificate is already revoked
- `401`: Unauthorized
- `404`: Certificate not found
- `500`: Internal server error

---

[API](https://skmtc.dev/sslwebsites/apis/sslwebsites-com-api.md) · [All operations](https://skmtc.dev/sslwebsites/apis/sslwebsites-com-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sslwebsites/apis/sslwebsites-com-api/revisions/16dfd60144a0?raw)