---
title: "Removes the specified policy management certificate. Note that the final policy management certificate cannot be removed."
method: POST
path: "/certificates:remove"
---

# Removes the specified policy management certificate. Note that the final policy management certificate cannot be removed.

`POST /certificates:remove`

Removes the specified policy management certificate. Note that the final policy
management certificate cannot be removed.

## Query parameters

- `api-version` string, required

## Request body

- RemovePolicyCertificateRequest — Request model for removing a policy certificate
  - `policyCertificateToRemove` string, required — The certificate to remove, as a string (e.g., PEM or JWK)

## Response `200`

The request has succeeded.

- PolicyCertificatesModifyResponse — The response to an attestation policy management API
  - `token` string — An RFC7519 JSON Web Token structure whose body is a PolicyCertificatesModificationResult object.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2018-09-01-preview) `74e240995f3e` — 1 info
  - api tag `Policy Management Certificates` removed
- **2026-07-13** (2018-09-01-preview) `e2463a10f80d` — 1 breaking
  - api path removed without deprecation
- **2026-07-13** (2018-09-01-preview) `cb7cc16888f7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/attestation-attestation/changes/certificates:remove/post.md)

---

[API](https://skmtc.dev/azure/apis/attestation-attestation.md) · [All operations](https://skmtc.dev/azure/apis/attestation-attestation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/attestation-attestation/revisions/74e240995f3e/schema)
