# Delete icon

Soft-delete a custom icon. The icon is marked as inactive rather than permanently deleted. Only works for custom icons (not system icons).

#### Path Parameters

**`org_id`** string required

The ID of the organization that owns the icon.

**`icon_id`** string required

The ID of the icon to delete.

## Returns

Returns `204 No Content` on successful deletion. No response body is returned.

Request

```bash cURL
curl -X DELETE https://api.aitronos.com/v1/icons/organizations/org_123/icon_abc123 \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python Python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]
org_id = "org_123"
icon_id = "icon_abc123"

url = f"https://api.aitronos.com/v1/icons/organizations/{org_id}/{icon_id}"
headers = {"X-API-Key": api_key}

response = requests.delete(url, headers=headers)

if response.status_code == 204:
    print("Icon deleted successfully")
```


```javascript JavaScript
const apiKey = process.env.FREDDY_API_KEY;
const orgId = 'org_123';
const iconId = 'icon_abc123';

const response = await fetch(
  `https://api.aitronos.com/v1/icons/organizations/${orgId}/${iconId}`,
  {
    method: 'DELETE',
    headers: {
      'X-API-Key': apiKey
    }
  }
);

if (response.status === 204) {
  console.log('Icon deleted successfully');
  // No response body for 204 No Content
}
```

Response

``` 204 No Content
Empty response body. The icon has been successfully deleted.
```


```json 403 Forbidden - System icon
{
  "success": false,
  "error": {
    "code": "CANNOT_DELETE_SYSTEM_ICON",
    "message": "System icons cannot be deleted",
    "type": "client_error",
    "status": 403,
    "details": {
      "icon_id": "icon_abc123",
      "is_system": true
    },
    "trace_id": "abc-123-def",
    "timestamp": "2025-12-03T10:00:00Z"
  }
}
```


```json 404 Not Found
{
  "success": false,
  "error": {
    "code": "ICON_NOT_FOUND",
    "message": "Icon not found",
    "type": "client_error",
    "status": 404,
    "details": {
      "icon_id": "icon_invalid123"
    },
    "trace_id": "abc-123-def",
    "timestamp": "2025-12-03T10:00:00Z"
  }
}
```