Folders

Create a new folder in your Dovetail workspace. Folders organize projects, docs, channels, and other content into a hierarchical structure.

Optionally provide a parent_folder_id to nest the folder inside an existing folder. If omitted, the folder is created at the workspace root level.

Returns the newly created folder object.

🚧 Permissions

Please check you have the relevant permissions required to access this resource. This may include specific permissions on the object itself or its parent, or having the correct user role if you're making updates.

Required scope: folder:write

post/v1/folders

Request

  • Base URL
    https://dovetail.com/api
  • URL
    https://dovetail.com/api/v1/folders
  • Auth
    HTTP bearer

Request body

titlestring required

The folder's title.

parent_folder_idstring

The ID of the parent folder. If omitted, the folder is created at the root level.

Example request

{
  "title": "My Folder"
}

Response

201

Changes

    • breaking

      added subschema #1 subschema #2 to the / response property oneOf list for the response status

    • breaking

      the / response's property type changed from object to no type for status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • warning

      removed the optional property // from the response with the status