div
strong
🔨 In Development
 — This section is still being developed and may change.

Delete (soft delete) a pricing tier.

**Admin only** - Requires admin privileges. Default pricing tiers (tier_standard, tier_poc, tier_enterprise) cannot be deleted.

## Path Parameters

**`tier_id`** string required

The unique identifier of the pricing tier to delete.

## Returns

Returns a 204 No Content response on successful deletion.


```bash cURL
curl -X DELETE https://api.aitronos.com/v1/pricing-tiers/tier_custom \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python Python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]
response = requests.delete(
    "https://api.aitronos.com/v1/pricing-tiers/tier_custom",
    headers={"X-API-Key": api_key}
)
```


```javascript JavaScript
const apiKey = process.env.FREDDY_API_KEY;
const response = await fetch(
  'https://api.aitronos.com/v1/pricing-tiers/tier_custom',
  {
    method: 'DELETE',
    headers: {
      'X-API-Key': apiKey
    }
  }
);
```

## Response

Returns 204 No Content on success.

## Error Responses

### 404 Not Found


```json
{
  "success": false,
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Pricing tier 'tier_custom' not found",
    "status": 404
  }
}
```

### 409 Conflict


```json
{
  "success": false,
  "error": {
    "code": "OPERATION_NOT_ALLOWED",
    "message": "Cannot delete default pricing tier 'tier_standard'",
    "status": 409,
    "details": {
      "tier_id": "tier_standard"
    }
  }
}
```