Skip to main content
POST
/
v1
/
folders
curl --request POST \
  --url https://api.caret.so/v1/folders \
  --header 'X-API-Key: <your_api_key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Project Alpha",
    "ownerUserId": "usr_123456789",
    "icon": "📁",
    "color": "#4A90E2",
    "isPrivate": false
  }'

{
  "folder": {
    "id": "fld_123456789",
    "name": "Project Alpha",
    "icon": "📁",
    "parentFolderId": null,
    "createdAt": "2024-01-28T12:00:00Z"
  }
}

​
Body

​
name
string
required
Name of the folder
​
ownerUserId
string
required
User ID of the folder owner
​
icon
string
Icon for the folder
​
color
string
Color for the folder
​
isPrivate
boolean
Whether the folder is private
​
parentFolderId
string
Parent folder ID

​
Response

​
folder
Folder
curl --request POST \
  --url https://api.caret.so/v1/folders \
  --header 'X-API-Key: <your_api_key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Project Alpha",
    "ownerUserId": "usr_123456789",
    "icon": "📁",
    "color": "#4A90E2",
    "isPrivate": false
  }'

{
  "folder": {
    "id": "fld_123456789",
    "name": "Project Alpha",
    "icon": "📁",
    "parentFolderId": null,
    "createdAt": "2024-01-28T12:00:00Z"
  }
}