MOmoda
drive

Update Item

Changed on

Rename a folder/canvas/file, and/or set canvas/file visibility.

Renames run the same service paths as the app (folder — edit permission + per-location uniqueness; canvas — the metadata updater behind PATCH /v1/canvases; file — edit permission). Visibility runs the shared item_visibility setters — the app's exact rules: a canvas's visibility can only be changed by its creator; a file's needs edit permission. private hides the item from teammates.

patch/drive/items/{item_ref}

Request

  • Base URL
    https://api.moda.app/v1
  • URL
    https://api.moda.app/v1/drive/items/{item_ref}
  • Auth
    HTTP bearer

Path parameters

item_refstring required

Headers

Moda-Version'2026-04-12' | '2026-05-01'
Example:2026-05-01

Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.

Request body

namestring nullable

New display name.

visibility'team' | 'private' nullable

New visibility — canvases and files only (folders are rejected). private hides the item from teammates; team makes it visible to the whole team. Canvas visibility can only be changed by its creator; file visibility needs edit permission (the app's own rules).

Response

Successful Response

object required

Changes