---
search:
  tags:
    - administration
    - GET
seo:
  description: >-
    Retrieves all custom icons configured for the workspace. Reference for the
    GET /administration/custom-icons endpoint in the Leadtime Public API API.
sidebar:
  badge: GET
  label: List custom icons
title: List custom icons
type: openapi-operation
---
Retrieves all custom icons configured for the workspace.

**What are Custom Icons?**
Custom icons are user-uploaded symbols (images) that can be used throughout the workspace to visually organize and tag content. They help make information easier to grasp quickly.

**Where can custom icons be used:**
- Projects
- Tickets/Tasks
- Documents
- Organization profiles
- Employee profiles

**What is returned:**
- Icon ID and name (e.g., `:company_logo:` or `:team_sales:`)
- Image file ID and public URL
- Author information (who created the icon)
- Creation and last update timestamps

**Note:** This endpoint requires the `CustomIcons.create` permission. All custom icons are available to all users in the workspace.

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