# Update icon metadata

Update metadata for a custom icon. 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 update.

#### Request Body

**`name`** string optional

Updated name for the icon.

**`description`** string optional

Updated description for the icon.

**`tags`** array optional

Updated array of tags for the icon.

**`is_active`** boolean optional

Set to `false` to soft-delete the icon, or `true` to restore it.

## Returns

Returns the updated [Icon object](/docs/api-reference/objects/icon-object) if successful.

Request

```bash cURL
curl -X PATCH https://api.aitronos.com/v1/icons/organizations/org_123/icon_abc123 \
  -H "X-API-Key: $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Icon Name",
    "description": "Updated description",
    "tags": ["updated", "tags"],
    "is_active": true
  }'
```


```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,
    "Content-Type": "application/json"
}

data = {
    "name": "Updated Icon Name",
    "description": "Updated description",
    "tags": ["updated", "tags"],
    "is_active": True
}

response = requests.patch(url, headers=headers, json=data)
updated_icon = response.json()
print(f"Updated icon: {updated_icon['name']}")
```


```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: 'PATCH',
    headers: {
      'X-API-Key': apiKey,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      name: 'Updated Icon Name',
      description: 'Updated description',
      tags: ['updated', 'tags'],
      is_active: true
    })
  }
);

const updatedIcon = await response.json();
console.log('Updated icon:', updatedIcon.name);
```

Response

```json 200 OK
{
  "id": "icon_abc123def456ghi789",
  "name": "Updated Icon Name",
  "description": "Updated description",
  "tags": ["updated", "tags"],
  "category": "custom",
  "file_format": "png",
  "is_system": false,
  "is_active": true,
  "url": "/v1/icons/icon_abc123def456ghi789",
  "created_at": "2025-12-03T10:00:00Z",
  "updated_at": "2025-12-03T10:05:00Z"
}
```


```json 403 Forbidden - System icon
{
  "success": false,
  "error": {
    "code": "CANNOT_MODIFY_SYSTEM_ICON",
    "message": "System icons cannot be modified",
    "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"
  }
}
```