Folders Overview

Folders provide hierarchical organization for Saved Searches within a project. Each folder has an explicit order field to maintain custom sorting while supporting concurrent edits.

Component Collections serve as the folder mechanism for organizing components, so folders are not used for components.

The Folder Object

string

Unique identifier (UUID)

string

Display name

string

Parent folder ID (null for root level)

string

Folder type: content or asset (must match saved searches it contains)

number

Decimal number for sibling ordering

string

Creation timestamp (ISO format)

string

Last update timestamp (ISO format)

Example Content Folder

{
  "id": "folder123",
  "name": "Marketing Content Searches",
  "parentId": null,
  "type": "content",
  "order": 1.0,
  "createdAt": "2024-03-20T10:00:00Z",
  "updatedAt": "2024-03-20T10:00:00Z"
}

Example Asset Folder

{
  "id": "folder456",
  "name": "Image Asset Searches",
  "parentId": null,
  "type": "asset",
  "order": 2.0,
  "createdAt": "2024-03-20T10:00:00Z",
  "updatedAt": "2024-03-20T10:00:00Z"
}

Permissions

Folder permissions are inherited from the saved searches they organize:

Content folders require content read permissions
Asset folders require assets read permissions

Folder Types

Folders are typed to ensure consistency:

Type	Contains
`content`	Content saved searches
`asset`	Asset saved searches

Saved searches can only be moved to folders that match their type. Content saved searches cannot be moved to asset folders, and vice versa.

Ordering

The order field uses decimal numbers to allow inserting items between existing items without reordering:

Initial items: 1.0, 2.0, 3.0
Insert between 1 and 2: 1.5
Insert between 1 and 1.5: 1.25

Getting Started

API Basics

Organizations

Projects

Saved Searches

Folders

Components

Component Assets

Collections

Packages

Draft Packages

Content Types

Content

Assets

Asset Searching

Tags

Roles

API Keys

The Folder Object

Example Content Folder

Example Asset Folder

Permissions

Folder Types

Ordering

​The Folder Object

​Example Content Folder

​Example Asset Folder

​Permissions

​Folder Types

​Ordering

The Folder Object

Example Content Folder

Example Asset Folder

Permissions

Folder Types

Ordering