Folders
Create, update, list, and delete folders.
|
Endpoints
| GET | /api/v1/cloud/folders | List folders |
| POST | /api/v1/cloud/folders | Create a folder |
| GET | /api/v1/cloud/folders/{id} | Get a folder |
| PATCH | /api/v1/cloud/folders/{id} | Update a folder |
| DELETE | /api/v1/cloud/folders/{id} | Delete a folder |
GET
/api/v1/cloud/foldersList folders
Authentication required— Include session cookie or Bearer token
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
parent_id | string | Optional | Filter by parent folder ID |
limit | integer | Optional | Number of items to return (default: 50, max: 200) |
offset | integer | Optional | Number of items to skip |
Code Examples
curl "https://api.blueai.jp/api/v1/cloud/folders" \
-H "Cookie: better-auth.session_token=<token>"POST
/api/v1/cloud/foldersCreate a folder
Authentication required— Include session cookie or Bearer token
Code Examples
curl -X POST "https://api.blueai.jp/api/v1/cloud/folders" \
-H "Cookie: better-auth.session_token=<token>"GET
/api/v1/cloud/folders/{id}Get a folder
Authentication required— Include session cookie or Bearer token
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Optional | Folder ID |
Code Examples
curl "https://api.blueai.jp/api/v1/cloud/folders/folder_123e4567e89b12d3a456426614174000" \
-H "Cookie: better-auth.session_token=<token>"PATCH
/api/v1/cloud/folders/{id}Update a folder
Authentication required— Include session cookie or Bearer token
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Optional | Folder ID |
Code Examples
curl -X PATCH "https://api.blueai.jp/api/v1/cloud/folders/folder_123e4567e89b12d3a456426614174000" \
-H "Cookie: better-auth.session_token=<token>"DELETE
/api/v1/cloud/folders/{id}Delete a folder
Authentication required— Include session cookie or Bearer token
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Optional | Folder ID |
Code Examples
curl -X DELETE "https://api.blueai.jp/api/v1/cloud/folders/folder_123e4567e89b12d3a456426614174000" \
-H "Cookie: better-auth.session_token=<token>"