Skip to main content
POST
folders
Create folder
curl --request POST \
  --url https://lowell-disintegrable-naughtily.ngrok-free.dev/api/v1/folders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "workspace_id": 123,
  "name": "<string>",
  "color": "<string>",
  "parent_id": 123
}
'

​
Create folder

Creates a folder in the given workspace. Use the returned id as folder_id on POST /media/upload/file or POST /media/upload/url.

​
Body

​
workspace_id
integer
required
Workspace that will own the folder
​
name
string
required
Display name
​
color
string
Hex color (e.g. #4F46E5). Defaults to #4F46E5 if omitted.
​
parent_id
integer
Optional parent folder id (must be in the same workspace)
Requires the posts ability.

​
See also

List folders