← API reference
Mutation / files

updateFolder

Patches a folder. Omitted fields are left unchanged. A folder that files already reference may not have its binding or root path changed (stored file handles would resolve against the wrong transport/prefix), and the tenant default may be moved to another folder but never simply unset. Requires folder:write permission.

Arguments

Folder ID to update

The fields to change; omitted fields keep their stored values.

Returns FolderPayload!

Explore in a view

Print PrepressProduction Floor
View exact SDL
"""
Patches a folder. Omitted fields are left unchanged. A folder that files already reference may not have its binding or root path changed (stored file handles would resolve against the wrong transport/prefix), and the tenant default may be moved to another folder but never simply unset. Requires folder:write permission.
"""
updateFolder(
  """Folder ID to update"""
  id: FolderID!
  """The fields to change; omitted fields keep their stored values."""
  input: UpdateFolderInput!
): FolderPayload! @topic(names: ["files"])

Schema reference describes the API contract. Actual access is checked by the platform for every operation.