> ## Documentation Index
> Fetch the complete documentation index at: https://uselora.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Lora API — Folder icons

> The icon keys a folder accepts and how to set an icon and a color.

A folder has an optional `icon` and an optional `color`. Both are `null` for the plain folder icon. Both can be set when you create a folder (`POST /folders`) and changed with `PATCH /folders/{id}`.

## Icon

`icon` is one of two forms:

* `icon:<key>`, for an icon from the set below. Example: `icon:fitness`.
* `emoji:<emoji>`, for exactly one emoji. Example: `emoji:🚀`.

Any other value returns 400 `validation_error` with `fieldErrors.icon`. That includes a key that is not in the set, more than one emoji, and a value without a prefix.

Send `null` in a `PATCH` to go back to the plain folder icon. Omit the field to leave it as it is.

A response can contain an `icon:` key that is not in this list, for example one that was later removed. Treat a key you don't recognize as the plain folder icon.

## Color

`color` is one of the tag colors: `DEFAULT`, `GRAY`, `BROWN`, `ORANGE`, `YELLOW`, `GREEN`, `BLUE`, `PURPLE`, `PINK` or `RED`. `DEFAULT` and `null` both draw the default slate. An emoji sits on a tile of this color.

Send `null` in a `PATCH` to clear it. Omit the field to leave it as it is.

The default "All Shortcuts" folder can't be edited. A `PATCH` to it returns 403 `system_folder`.

## Icon keys

### Departments & functions

`people`, `finance`, `billing`, `sales`, `marketing`, `engineering`, `legal`, `support`, `operations`, `it`, `security`, `design`, `product`, `data`, `analytics`, `procurement`, `quality`, `management`, `payroll`, `expenses`, `tax`, `time`

### Work & projects

`projects`, `tasks`, `goals`, `roadmap`, `ideas`, `documents`, `contracts`, `notes`, `meetings`, `presentations`, `templates`, `archive`, `research`, `launch`, `automation`, `email`, `chat`, `feedback`, `bookmarks`, `favorites`, `onboarding`

### Customers & partners

`customers`, `partners`, `investors`, `press`, `community`, `social`, `website`, `international`, `translations`

### Offices & locations

`office`, `locations`, `map`, `home`, `city`, `warehouse`, `delivery`, `factory`, `store`, `hotel`, `restaurant`, `coffee`, `government`

### Travel

`travel`, `tickets`, `luggage`, `car`, `train`, `ship`

### Events & team activities

`event`, `party`, `birthday`, `gifts`, `awards`, `team`, `music`, `movies`, `games`, `board-games`, `podcast`, `photos`, `video`

### Outdoor & sport

`fitness`, `sports`, `yoga`, `hiking`, `outdoor`, `camping`, `running`, `cycling`, `water`, `sailing`, `winter`, `summer`, `fishing`, `pets`, `garden`, `sustainability`, `cooking`, `drinks`

### Learning & ideas

`learning`, `books`, `knowledge`, `writing`, `illustration`, `art`, `science`, `ai`, `mind`, `puzzle`

### Health & wellbeing

`health`, `doctor`, `hospital`, `pharmacy`, `insurance`, `culture`, `family`, `safety`

### Tools & media

`tools`, `settings`, `integrations`, `terminal`, `cloud`, `servers`, `bugs`, `mobile`, `phone`, `passwords`, `confidential`, `printing`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.