Skip to main content
POST
Create a folder
Minimum required API key scope: Read/Write

Use Cases

  • Set Up a Project: Create a folder tree for a new project or client.
  • Safe Retries: When the folder already exists, the 409 response includes existing_folder_id, so a script or agent can use that folder and continue.

Headers

X-Dune-Api-Key
string
required

API Key for the service

Query Parameters

api_key
string

API Key, alternative to using the HTTP header X-Dune-Api-Key

Body

application/json

Folder to create

name
string
required
Example:

"RWA"

color
string

Color is a preset (green, yellow, red, blue-light, gray, orange, blue, pink, mauve, amber) or a hex value such as #E5477D. Defaults to "gray".

Example:

"blue"

description
string
icon
string

Icon defaults to "folder".

Example:

"rocket"

parent_folder_id
string

ParentFolderID creates the folder inside another folder; omit it for the library root.

Example:

"aZ3kP0qLm9Xc"

Response

OK

color
string

Color is a preset name or a hex value.

Example:

"blue"

created_at
string
description
string
folder_id
string
Example:

"dp180Cu3jW3L"

icon
string
Example:

"folder"

name
string
Example:

"RWA"

parent_folder_id
string

ParentFolderID is null for a folder at the library root.

Example:

"aZ3kP0qLm9Xc"

path
string

Path is the full path from the library root.

Example:

"/Research/RWA"

updated_at
string