Deskhero Developer Hub
Back to deskhero.com
Icons

Get one

Returns one icon from the built-in catalogue as metadata (name, tags, categories and the relative path of its SVG file), which the client then fetches itself; the response is not the image. The catalogue is shared by all workspaces, icons that are not public answer as not found, and the response is marked cacheable for 5 minutes.

GET /api/sys/v{version:apiVersion}/icons/{id}
Authorisation
Minimum role: USER

Request arguments

Name Type Source
idInt32
Request body example

Response

Status
200 (OK)
Type
DTO_icon
Wrapper
DTO_response_wrap
Other statuses
400 (BadRequest), 403 (Forbidden)
Response body example
DTO_icon
NameTypeReadOnlyDescription
idInt32Id
nameStringName
fileStringFile
tagsString[]Tags
categoriesString[]Categories

Generated Aug 4, 2026 18:37