Serve icon
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

Get the actual icon file with optional quality transformation. Returns the binary image data.

GEThttps://api.aitronos.com/v1/icons/{icon_id}

icon_id string required

The ID of the icon to retrieve.

quality string optional · Defaults to medium

Image quality/size level. Options:

Note: SVG icons always return original regardless of quality parameter.

Returns

Returns binary image data with appropriate Content-Type header (image/svg+xml, image/png, or image/jpeg).

Response includes optimized caching headers:

System icons (connectors): Cache-Control: public, max-age=86400, immutable (24 hours)
Custom icons: Cache-Control: public, max-age=3600, immutable (1 hour)
ETag: Unique identifier for cache validation ("{icon_id}-{quality}")
Vary: Accept-Encoding for proper compression handling

The immutable directive indicates the resource won't change for the given URL, enabling aggressive browser caching.

cURL - Get medium quality (default)

curl https://api.aitronos.com/v1/icons/icon_abc123 \
  -H "X-API-Key: $FREDDY_API_KEY" \
  -o icon.png