메인 콘텐츠로 건너뛰기
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
필수
폴더 이름
​
ownerUserId
string
필수
폴더 소유자의 사용자 ID
​
icon
string
폴더 아이콘
​
color
string
폴더 색상
​
isPrivate
boolean
폴더가 비공개인지 여부
​
parentFolderId
string
상위 폴더 ID

​
응답

​
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"
  }
}