Folders

Organize files with folders

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