Ban a PKI certificate

View as Markdown
POST
/truststores/pki/{trust_store_id}/banned_certificates

Creates a banned certificate entry in the specified PKI trust store, preventing certificates matching the provided identifier from being trusted during mTLS authentication.

Authorization

API-Key
headerX-API-KEY<token>

MonoCloud APIs require authentication with an API key. Retrieve your key from the Tenant Settings section of the MonoCloud dashboard and include it in the request header as: X-API-Key: <your_api_key>

Path Parameters

trust_store_id*string

The unique identifier of the trust store.

Request Body

application/json

The request payload used to ban a certificate.

TypeScript Definitions

Use the request body type in TypeScript.

Ban Trust Store Certificate Request: Defines a certificate identifier to be banned from mTLS authentication within a trust store.

Response Body

200

application/json

The certificate was banned successfully

TypeScript Definitions

Use the response body type in TypeScript.

Banned Certificate Response: Represents a certificate that has been explicitly banned within a trust store.

Errors

401Unauthorized

403Forbidden

curl -X POST "https://your-domain.us.monocloud.com/api/truststores/pki/9qVBxPQiZqtUsBOykavK6/banned_certificates" \  -H "X-API-KEY: <token>" \  -H "Content-Type: application/json" \  -d '{    "value": "string"  }'
{  "id": "string",  "type": "thumbprint",  "value": "string",  "reason": null,  "creation_time": 0}
© 2026 MonoCloud. All rights reserved.