Folder Templates

List folder templates for a workspace

get

Query parameters

workspace_idstring · uuidRequired

The id of the workspace to get folder templates from

drive_idany ofOptional

Optional drive id to filter templates specific to that drive

string · uuidOptional

or

nullOptional

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

or

nullOptional

Body

application/json

Responses

200

A list of folder templates

application/json

404

Not found

422

Validation Error

application/json

get

/folder-templates

HTTPcURLJavaScriptPython

GET /folder-templates?workspace_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "drive_id": "123e4567-e89b-12d3-a456-426614174000",
    "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "icon": "text",
    "created": "2026-01-22T14:27:12.899Z",
    "created_by": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "email": "text",
      "avatar_url": "text",
      "user_type": "regular"
    },
    "paths": [
      "text"
    ]
  }
]

Create a folder template from an existing folder

post

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

or

nullOptional

Body

application/json

namestringRequired

The name of the folder template

descriptionstringOptional

A brief description of how to use this template

Default: ""

iconstringOptional

Icon key used by the client when displaying this template

Default: ""

workspace_idstring · uuidRequired

The id of the workspace this template belongs to (always required)

drive_idany ofOptional

Optional drive id if this template is specific to a drive within the workspace

string · uuidOptional

or

nullOptional

root_pathstring · pathRequired

The absolute path of the folder to capture as a template

Responses

200

The created folder template

application/json

404

Not found

422

Validation Error

application/json

post

/folder-templates

HTTPcURLJavaScriptPython

POST /folder-templates HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 211

{
  "name": "text",
  "description": "",
  "icon": "",
  "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "root_path": "text",
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "icon": "text",
  "created": "2026-01-22T14:27:12.899Z",
  "created_by": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "email": "text",
    "avatar_url": "text",
    "user_type": "regular"
  },
  "paths": [
    "text"
  ]
}

Delete a folder template

delete

Path parameters

template_idstring · uuidRequired

The ID of the folder template to delete

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

or

nullOptional

Body

application/json

Responses

200

True if the template was deleted successfully

application/json

Responseboolean

404

Not found

422

Validation Error

application/json

delete

/folder-templates/{template_id}

HTTPcURLJavaScriptPython

DELETE /folder-templates/{template_id} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

true

Update a folder template

patch

Path parameters

template_idstring · uuidRequired

The ID of the folder template to update

Header parameters

passwordany ofOptional

The password header to use to fetch the preview

stringOptional

or

nullOptional

Body

application/json

nameany ofOptional

The new name for the folder template

stringOptional

or

nullOptional

descriptionany ofOptional

The new description for the folder template

stringOptional

or

nullOptional

iconany ofOptional

The new icon key for the folder template

stringOptional

or

nullOptional

Responses

200

The updated folder template

application/json

404

Not found

422

Validation Error

application/json

patch

/folder-templates/{template_id}

HTTPcURLJavaScriptPython

PATCH /folder-templates/{template_id} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 96

{
  "name": "text",
  "description": "text",
  "icon": "text",
  "body": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "drive_id": "123e4567-e89b-12d3-a456-426614174000",
  "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "icon": "text",
  "created": "2026-01-22T14:27:12.899Z",
  "created_by": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "email": "text",
    "avatar_url": "text",
    "user_type": "regular"
  },
  "paths": [
    "text"
  ]
}