Skip to main content
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