> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metabind.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Folders Overview

> Organize saved searches with hierarchical folders

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.

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

## The Folder Object

<ResponseField name="id" type="string">
  Unique identifier (UUID)
</ResponseField>

<ResponseField name="name" type="string">
  Display name
</ResponseField>

<ResponseField name="parentId" type="string">
  Parent folder ID (null for root level)
</ResponseField>

<ResponseField name="type" type="string">
  Folder type: `content` or `asset` (must match saved searches it contains)
</ResponseField>

<ResponseField name="order" type="number">
  Decimal number for sibling ordering
</ResponseField>

<ResponseField name="createdAt" type="string">
  Creation timestamp (ISO format)
</ResponseField>

<ResponseField name="updatedAt" type="string">
  Last update timestamp (ISO format)
</ResponseField>

### Example Content Folder

```json theme={null}
{
  "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

```json theme={null}
{
  "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   |

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

## 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`