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:🚀.
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