---
title: "Revoke credentials"
method: PUT
path: "/api/v1/credential/{name}/revoke"
tags: ["Delegated RA"]
---

# Revoke credentials

`PUT /api/v1/credential/{name}/revoke`

## Request

- Base URL: `https://one.digicert.com/documentmanager`
- URL: `https://one.digicert.com/documentmanager/api/v1/credential/{name}/revoke`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/digicert/apis/digicert-content-trust-manager/docs/api/v1/credential/:name/revoke/put.ts> (a function with typed inputs; its response is checked against the schema)

With this API we can revoke a credential.<br> This API can be called only if status of credential is ‘ACTIVE' OR 'suspended'.

## Path parameters

- `name` string, required: Credential Name

## Query parameters

- `user_id` string, required: DTM user id of signer whose credential is being revoked

## Request body

- RevokeCredentialRequest
  - `reason` 'KEY_COMPROMISE' | 'AFFILIATION_CHANGED' | 'SUPERSEDED' | 'CESSATION_OF_OPERATION', required

## Response `200`

Credential details

- ListCredentialsDetailsItem
  - `created_by` string
  - `modified_on` string, date-time
  - `modified_by` string
  - `created_on` string, date-time
  - `credential_id` string
  - `label` string
  - `key_algorithm` string
  - `key_size` integer
  - `status` string
  - `profile_id` string
  - `userId` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/digicert/apis/digicert-content-trust-manager.md) - [All operations](https://skmtc.dev/digicert/apis/digicert-content-trust-manager/llms.txt) - [OpenAPI document](https://skmtc.dev/digicert/apis/digicert-content-trust-manager/revisions/8dec322a0e2b?raw)