フォルダの作成 (Create Folder)

POST/apiv2/pub/foldersdocuments_write

新しいフォルダを作成します。トークンユーザーが所属するすべてのグループにアクセス権が付与されます。

リクエスト

Content-Type: application/json

フィールド	型	必須	デフォルト	説明
name	string	必須	—	フォルダの表示名。
parent_id	integer	任意	0	親フォルダの ID。0 はルートレベルを表します。

---

レスポンス

200 OK — 作成されたフォルダ。

---

エラー

ステータス	理由
401	トークンが無効または期限切れです
403	トークンに documents_write スコープがありません
422	name が指定されていないか無効です

cURL

curl -i -X POST "https://portal.docwize.com/apiv2/pub/folders" \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -H "Content-Type: application/json" \
     -d '{"name":"Q1 Reports","parent_id":10}'

---

{
  "folder_id": 55,
  "name": "Q1 Reports",
  "full_path": "Finance->Q1 Reports",
  "parent_id": 10,
  "code": "c4d5e6f7-...",
  "child_count": 0
}

{"detail": "Missing or invalid name"}