---
search:
  tags:
    - administration
    - PUT
seo:
  description: >-
    Updates an existing custom icon by replacing its image. Reference for the
    PUT /administration/custom-icons/{id} endpoint in the Leadtime Public API
    API.
sidebar:
  badge: PUT
  label: Update custom icon
title: Update custom icon
type: openapi-operation
---
Updates an existing custom icon by replacing its image.

**What can be updated:**
- **Image only**: The icon image can be replaced with a new one
- **Name is readonly**: The icon name cannot be changed after creation

**How to update a custom icon:**
1. Upload a new image file (PNG or SVG format) using POST /api/public/workspace/upload
2. Get the file ID from the upload response
3. Use the file ID in the `imageId` field

**Note:** This endpoint requires the `CustomIcons.create` permission. The icon name remains unchanged - only the image is updated. The updated icon will be reflected throughout the workspace wherever it's used.

<Operation source="api-reference" id="customiconscontroller-updatecustomicon" />