Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/directus/directus/llms.txt

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

Folders allow you to organize files into a hierarchical structure.

List Folders

Retrieve all folders.
GET /folders
Example:
curl "https://your-directus-instance.com/folders" \
  -H "Authorization: Bearer YOUR_TOKEN"

Get Folder

Retrieve a single folder.
GET /folders/:id

Create Folder

Create a new folder.
POST /folders
Request Body:
{
  "name": "Images",
  "parent": null
}
Example:
curl -X POST "https://your-directus-instance.com/folders" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Documents"
  }'

Create Nested Folder

Create a folder inside another folder:
{
  "name": "Photos",
  "parent": "abc-123-def"
}

Update Folder

Update folder metadata.
PATCH /folders/:id
Request Body:
{
  "name": "Updated Name"
}

Delete Folder

Delete a folder.
DELETE /folders/:id
Deleting a folder also deletes all files within it. This action cannot be undone.

Folder Properties

id
string
Unique folder identifier (UUID)
name
string
Folder name
parent
string
Parent folder ID (null for root)

Next Steps

Files

Manage files

File Storage

Configure storage