フォルダの移動 (Move Folder)
POST/apiv2/pub/folders/{folder_id}/movedocuments_write
フォルダを新しい親フォルダに移動します。すべての子孫のパスとドキュメントの関連付けはアトミックに更新されます。
リクエスト
Content-Type: application/json
パスパラメータ
| パラメータ | 型 | 説明 |
|---|---|---|
folder_id | integer | 移動するフォルダ。 |
本文
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
new_parent_id | integer | 必須 | 移動先の親フォルダ。0 はルートへの移動を意味します。 |
レスポンス
200 OK — 更新された full_path を持つ、移動後のフォルダ。
エラー
| ステータス | 理由 |
|---|---|
| 400 | 自身の子孫の中には移動できません |
| 401 | トークンが無効または期限切れです |
| 404 | フォルダまたは移動先が見つかりません |
cURL
curl -i -X POST "https://portal.docwize.com/apiv2/pub/folders/42/move" \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
-H "Content-Type: application/json" \
-d '{"new_parent_id":99}'
{
"folder_id": 42,
"name": "Invoices",
"full_path": "Archive->Invoices",
"parent_id": 99,
"code": "a1b2c3d4-...",
"child_count": 3
}