---
title: "Revoke active certificate"
method: POST
path: "/v1/certificates/{certificateId}/revoke"
tags: ["v1"]
---

# Revoke active certificate

`POST /v1/certificates/{certificateId}/revoke`

Use revoke call to revoke an active certificate, if the certificate has not been issued a 404 response will be returned.

## Path parameters

- `certificateId` string, required

## Request body

- CertificateRevoke
  - `reason` 'AFFILIATION_CHANGED' | 'CESSATION_OF_OPERATION' | 'KEY_COMPROMISE' | 'PRIVILEGE_WITHDRAWN' | 'SUPERSEDED', required — Reason for revocation

## Response `204`

Certificate Revoked

## Other responses

- `400` — Request was malformed
- `401` — Authentication info not sent or invalid
- `403` — Authenticated user is not allowed access
- `404` — Certificate id not found
- `409` — Certificate state does not allow revoke
- `500` — Internal server error

---

[API](https://skmtc.net/godaddy/apis/untitled-api-2.md) · [All operations](https://skmtc.net/godaddy/apis/untitled-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/godaddy/untitled-api-2/revisions/100b3aa2d7ee/schema)
