items_update

io.github.tryflask/flask · Verify this server

Rename, move and/or change the sharing of folders and assets, up to 20 items per call, each with its own result. Per item: id (a folder id, an asset id, or a version id) plus at least one of: title (renames the folder, or the asset; a version id renames its asset), version_title (names that one version, as in the app's version list; version ids only), folder_id (move into this folder, or "root" for the team's top level; a version id moves its whole asset), link_access (what anyone with the item's link can do: comment_and_notes (comment and read version notes and files), comment, view, or none to close the link; never full_access), team_access (what the team's members can do by default: full_access, comment, view or none). Folders take view or none for the link and full_access, view or none for the team (no comment). Sharing is the app's Share tab: the item's url is the link to share. Change sharing only when the user asks. A folder cannot move into itself or its subfolders, nothing moves into an asset (to make media a version use versions_update, or upload with version_of), and nothing moves between teams. Each item is applied on its own and is not undone if another fails. An item already in the requested state reports changed: {} (safe to repeat). Each result lists changed fields as [from, to], so you can revert by calling again with the from values. Needs edit access on the item and on the target folder. The user's open Flask tabs are prompted to refresh.