Trash or restore a folder

PATCH 
/api/v1/buckets/:bucketId/folders/:folderId

Requires contributor role or above on this bucket. status: "deleted" moves the folder to trash; status: "created" restores it (restoring parent folders as needed).

Request

Responses

204

Folder status transitioned

400

Invalid status value (INVALID_STATUS)

401

Not authenticated. Note: a missing or invalid token is rejected with 403 FORBIDDEN (not 401); 401 is returned when the token's session has been revoked (SESSION_REVOKED).

403

Missing/invalid token, or the caller's role/group is below the required minimum (FORBIDDEN)

404

Folder not found (FOLDER_NOT_FOUND)

409

Invalid transition for the folder's current state (FOLDER_ALREADY_TRASHED, FOLDER_RESTORE_IN_PROGRESS, FOLDER_NAME_CONFLICT if a folder with the same name already exists at the restore destination)

410

Trash retention period has expired; the folder can no longer be restored (FOLDER_TRASH_EXPIRED)