Skip to main content
GET
/
v1
/
dev
/
user
/
folders
List folders
curl --request GET \
  --url https://api.omi.me/v1/dev/user/folders \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "folder_uuid_work",
    "name": "Work",
    "description": "Work, business, professional, and career-related conversations",
    "color": "#3B82F6",
    "icon": "💼",
    "created_at": "2025-01-15T10:00:00Z",
    "updated_at": "2025-01-20T13:50:00Z",
    "order": 0,
    "is_default": false,
    "is_system": true,
    "category_mapping": "work",
    "conversation_count": 12
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.omi.me/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Developer API key. Get one from Settings → Developer → Create Key in the Omi app. Keys are prefixed with omi_dev_.

Response

List of folders.

​
id
string

Unique identifier.

​
name
string

Display name of the folder.

Required string length: 1 - 100
​
description
string | null

Natural language description of what belongs in this folder.

Maximum string length: 500
​
color
string
default:#6B7280

Hex color code for the folder.

​
icon
string
default:folder

Emoji or icon identifier for the folder.

​
created_at
string<date-time>

When the folder was created.

​
updated_at
string<date-time>

When the folder was last updated.

​
order
integer
default:0

Display order index (lower = earlier).

​
is_default
boolean
default:false

Whether this is the default folder for unassigned conversations.

​
is_system
boolean
default:false

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

​
category_mapping
string | null

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

​
conversation_count
integer
default:0

Number of non-discarded conversations in this folder.