Sign in
Folders

List folders

Retrieve all folders for the authenticated user. This endpoint is strictly read-only and returns an empty list if the user has no folders yet. System folders (Work, Personal, Social) are initialized lazily through other paths (the mobile app opening the conversations screen, or the conversation post-processing pipeline), not by this endpoint.

get/v1/dev/user/folders

Response

List of folders.

idstring

Unique identifier.

namestring

Display name of the folder.

descriptionstring nullable

Natural language description of what belongs in this folder.

colorstring

Hex color code for the folder.

iconstring

Emoji or icon identifier for the folder.

created_atstring date-time

When the folder was created.

updated_atstring date-time

When the folder was last updated.

orderinteger

Display order index (lower = earlier).

is_defaultboolean

Whether this is the default folder for unassigned conversations.

is_systemboolean

True for category-based system folders (Work, Personal, Social).

category_mappingstring nullable

Maps to a CategoryEnum value for backwards compatibility with category-based filtering.

conversation_countinteger

Number of non-discarded conversations in this folder.

Changes