Google: Creates a copy of a file and applies any requested updates with patch semantics For more information, see Create and manage files (https: developers google com workspace drive api guides create-file) — response body — capabilities
Creates a copy of a file and applies any requested updates with patch semantics. For more information, see [Create and manage files](https://developers.google.com/workspace/drive/api/guides/create-file).: response body, field capabilities. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Creates a copy of a file and applies any requested updates with patch semantics For more information, see Create and manage files (https: developers google com workspace drive api guides create-file) — response body — capabilities
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | Output only. Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user may take. For more information, see [Understand file capabilities](https://developers.google.com/workspace/drive/api/guides/manage-sharing#capabilities). |
canAcceptOwnership | boolean | Optional | Output only. Whether the current user is the pending owner of the file. Not populated for shared drive files. |
canAccessViaGenAi | boolean | Optional | Whether the current user can access this file via Gen AI features. For more information, see [Drive MCP file eligibility](https://developers.google.com/workspace/drive/api/guides/drive-mcp-server-file-eligibility). |
canAddChildren | boolean | Optional | Output only. Whether the current user can add children to this folder. This is always `false` when the item isn’t a folder. |
canAddFolderFromAnotherDrive | boolean | Optional | Output only. Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is `false` when the item isn’t a folder. Only populated for items in shared drives. |
canAddMyDriveParent | boolean | Optional | Output only. Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files. |
canChangeCopyRequiresWriterPermission | boolean | Optional | Output only. Whether the current user can change the `copyRequiresWriterPermission` restriction of this file. |
canChangeItemDownloadRestriction | boolean | Optional | Output only. Whether the current user can change the owner or organizer-applied download restrictions of the file. |
canChangeSecurityUpdateEnabled | boolean | Optional | Output only. Whether the current user can change the `securityUpdateEnabled` field on link share metadata. |
canChangeViewersCanCopyContent | boolean | Optional | Deprecated: Output only. |
canComment | boolean | Optional | Output only. Whether the current user can comment on this file. |
canCopy | boolean | Optional | Output only. Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item if it’s not a folder. |
canDelete | boolean | Optional | Output only. Whether the current user can delete this file. |
canDeleteChildren | boolean | Optional | Output only. Whether the current user can delete children of this folder. This is `false` when the item isn’t a folder. Only populated for items in shared drives. |
canDisableInheritedPermissions | boolean | Optional | Whether a user can disable inherited permissions. |
canDownload | boolean | Optional | Output only. Whether the current user can download this file. |
canEdit | boolean | Optional | Output only. Whether the current user can edit this file. Other factors may limit the type of changes a user can make to a file. For example, see `canChangeCopyRequiresWriterPermission` or `canModifyContent`. |
canEnableInheritedPermissions | boolean | Optional | Whether a user can re-enable inherited permissions. |
canListChildren | boolean | Optional | Output only. Whether the current user can list the children of this folder. This is always `false` when the item isn’t a folder. |
canModifyContent | boolean | Optional | Output only. Whether the current user can modify the content of this file. |
canModifyContentRestriction | boolean | Optional | Deprecated: Output only. Use one of `canModifyEditorContentRestriction`, `canModifyOwnerContentRestriction`, or `canRemoveContentRestriction`. |
canModifyEditorContentRestriction | boolean | Optional | Output only. Whether the current user can add or modify content restrictions on the file which are editor restricted. |
canModifyLabels | boolean | Optional | Output only. Whether the current user can modify the labels on the file. |
canModifyOwnerContentRestriction | boolean | Optional | Output only. Whether the current user can add or modify content restrictions which are owner restricted. |
canMoveChildrenOutOfDrive | boolean | Optional | Output only. Whether the current user can move children of this folder outside of the shared drive. This is `false` when the item isn’t a folder. Only populated for items in shared drives. |
canMoveChildrenOutOfTeamDrive | boolean | Optional | Deprecated: Output only. Use `canMoveChildrenOutOfDrive` instead. |
canMoveChildrenWithinDrive | boolean | Optional | Output only. Whether the current user can move children of this folder within this drive. This is `false` when the item isn’t a folder. Note that a request to move the child may still fail depending on the current user’s access to the child and to the destination folder. |
canMoveChildrenWithinTeamDrive | boolean | Optional | Deprecated: Output only. Use `canMoveChildrenWithinDrive` instead. |
canMoveItemIntoTeamDrive | boolean | Optional | Deprecated: Output only. Use `canMoveItemOutOfDrive` instead. |
canMoveItemOutOfDrive | boolean | Optional | Output only. Whether the current user can move this item outside of this drive by changing its parent. Note that a request to change the parent of the item may still fail depending on the new parent that’s being added. |
canMoveItemOutOfTeamDrive | boolean | Optional | Deprecated: Output only. Use `canMoveItemOutOfDrive` instead. |
canMoveItemWithinDrive | boolean | Optional | Output only. Whether the current user can move this item within this drive. Note that a request to change the parent of the item may still fail depending on the new parent that’s being added and the parent that is being removed. |
canMoveItemWithinTeamDrive | boolean | Optional | Deprecated: Output only. Use `canMoveItemWithinDrive` instead. |
canMoveTeamDriveItem | boolean | Optional | Deprecated: Output only. Use `canMoveItemWithinDrive` or `canMoveItemOutOfDrive` instead. |
canReadDrive | boolean | Optional | Output only. Whether the current user can read the shared drive to which this file belongs. Only populated for items in shared drives. |
canReadLabels | boolean | Optional | Output only. Whether the current user can read the labels on the file. |
canReadRevisions | boolean | Optional | Output only. Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item if it’s not a folder, can be read. |
canReadTeamDrive | boolean | Optional | Deprecated: Output only. Use `canReadDrive` instead. |
canRemoveChildren | boolean | Optional | Output only. Whether the current user can remove children from this folder. This is always `false` when the item isn’t a folder. For a folder in a shared drive, use `canDeleteChildren` or `canTrashChildren` instead. |
canRemoveContentRestriction | boolean | Optional | Output only. Whether there’s a content restriction on the file that can be removed by the current user. |
canRemoveMyDriveParent | boolean | Optional | Output only. Whether the current user can remove a parent from the item without adding another parent in the same request. Not populated for shared drive files. |
canRename | boolean | Optional | Output only. Whether the current user can rename this file. |
canShare | boolean | Optional | Output only. Whether the current user can modify the sharing settings for this file. |
canStartApproval | boolean | Optional | Whether the current user can start an approval on the file. |
canTrash | boolean | Optional | Output only. Whether the current user can move this file to trash. |
canTrashChildren | boolean | Optional | Output only. Whether the current user can trash children of this folder. This is `false` when the item isn’t a folder. Only populated for items in shared drives. |
canUntrash | boolean | Optional | Output only. Whether the current user can restore this file from trash. |