# Ban a SVID (/docs/apis/management/trust-stores/BanSpiffeTrustStoreSvid)

`POST /truststores/spiffe/{trust_store_id}/banned_svids`

Creates a banned SVID entry in the specified SPIFFE trust store, preventing SVIDs matching the provided identifier from being trusted during authentication.

Base URL: `https://{tenant}.{region}.monocloud.com/api`, where `{tenant}`, `{region}` (one of us, eu, in) come from your tenant. Authentication: send your Management API key in the `X-API-KEY` header.

## Parameters

- `trust_store_id` (path) (string, required) The unique identifier of the trust store.

## Request body

JSON, required. The request payload used to ban a SVID.

- `value` (string, required) The identifier value used for banning.
- `reason` (string) The reason explaining why the SVID was banned.

## Response body

`200`, JSON. The SVID was banned successfully

Returns `BannedSvid`.

- `id` (string, required) The unique identifier of the banned SVID entry.
- `value` (string, required) The identifier value used for banning.
- `reason` (string) The reason explaining why the SVID was banned.
- `creation_time` (integer, required, date-time) Specifies the time at which the SVID was banned (in Epoch).

## Errors

- `400` Bad Request
  - `type` (string, required) A URI reference that identifies the error type. When accessed, it may provide human-readable documentation.
  - `title` (string, required) A short, human-readable summary of the error.
  - `status` (integer, required, int32) The HTTP status code associated with this error response.
  - `trace_id` (string, required) A unique identifier for the request, used for tracing and diagnostics.
  - `detail` (string) A human-readable explanation specific to this occurrence of the error.
  - `instance` (string) A URI reference that identifies the specific occurrence of the error.
- `401` Unauthorized
- `402` Payment Required
  Same body as `400`.
- `403` Forbidden
- `422` Unprocessable Entity
  - `type` (string, required) A URI reference that identifies the error type. When accessed, it may provide human-readable documentation.
  - `title` (string, required) A short, human-readable summary of the error.
  - `status` (integer, required, int32) The HTTP status code associated with this error response.
  - `trace_id` (string, required) A unique identifier for the request, used for tracing and diagnostics.
  - `detail` (string) A human-readable explanation specific to this occurrence of the error.
  - `instance` (string) A URI reference that identifies the specific occurrence of the error.
  - `errors` (Record<string, string[]>, required) A key-value map of validation errors, where each key represents a request field and the value contains one or more messages describing why the request could not be processed.

## Example (MonoCloud .NET SDK)

```csharp
using MonoCloud.Management;
using MonoCloud.Management.Models;
using MonoCloud.Management.Core.Base;

var apiClient = new MonoCloudManagementClient(new MonoCloudConfig("<your-domain>", "[[API-Key]]"));


var trustStoreId = "9qVBxPQiZqtUsBOykavK6";

var requestBody = new BanTrustStoreSvidRequest
  {
    Value = "spiffe://example.org/workload",
    Reason = "Privilege withdrawn",
  };


var result = await apiClient.TrustStores.BanSpiffeTrustStoreSvidAsync(trustStoreId, requestBody);
```

## Example (MonoCloud Javascript SDK)

```javascript
import { MonoCloudManagementClient } from '@monocloud/management';

const apiClient = MonoCloudManagementClient.init({ domain: '<your-domain>', apiKey: '[[API-Key]]' });

const trustStoreId = '9qVBxPQiZqtUsBOykavK6';

const requestBody = {
  value: 'spiffe://example.org/workload',
  reason: 'Privilege withdrawn'
};

const result = apiClient.trustStores.banSpiffeTrustStoreSvid(trustStoreId, requestBody);
```