---
title: "DELETE /certificates/{certificateId}"
method: DELETE
path: "/certificates/{certificateId}"
---

# DELETE /certificates/{certificateId}

`DELETE /certificates/{certificateId}`

Deletes the specified certificate.

A certificate cannot be deleted if it has a policy or IoT thing attached to it or if its status is set to ACTIVE. To delete a certificate, first use the DetachPolicy action to detach all policies. Next, use the UpdateCertificate action to set the certificate to the INACTIVE status.

Requires permission to access the [DeleteCertificate](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions) action.

## Path parameters

- `certificateId` string, required

## Query parameters

- `forceDelete` boolean

## Response `200`

Success

## Other responses

- `480` — CertificateStateException
- `481` — DeleteConflictException
- `482` — InvalidRequestException
- `483` — ThrottlingException
- `484` — UnauthorizedException
- `485` — ServiceUnavailableException
- `486` — InternalFailureException
- `487` — ResourceNotFoundException

---

[API](https://skmtc.net/aws/apis/iot.md) · [All operations](https://skmtc.net/aws/apis/iot/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iot/revisions/deef5c4b09f0/schema)