Rename, Move, or Categorize File

Renames a file (displayName), moves it to a different folder (folderId), and/or sets its free-text category label (category). Send only the fields you want to change — at least one must be present.

Set folderId to a folder id to move the file into that folder, or to null to move it to the owner’s top level. The target folder must belong to the same owner as the file. Renames change the display identity only — the stored bytes and the immutable original fileName never change.

Set category to any non-blank string (max 255 characters; leading and trailing whitespace is trimmed) or to null to clear it. Categories are free-text — there is no configured category list to match against.

folderId and category live on a placement, and a file shared to several entities has one placement per owner — so on a shared file this endpoint can only change displayName (which lives on the file itself); a folderId/category update returns 409 Conflict because the placement to change is ambiguous. Re-folder or re-categorize a shared file per placement with Update File Placement.

Required permission: company.file:update