> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# files_copy

> Create a copy of a file and apply any requested updates with patch semantics. Typically send a new `name` and optionally `parents`.

<div className="tool-route"><span className="tool-row-method" data-method="POST">POST</span><code>{"https://www.googleapis.com/drive/v3/files/{fileId}/copy"}</code></div>

```python gdrive_files_copy.py theme={null}
from charter.packs import gdrive

result = await gdrive.files_copy.ainvoke({"fileId": ..., "file": ...})
```

<Note>
  Requires `https://www.googleapis.com/auth/drive`. Costs 1 against the provider's own quota.
</Note>

## Path parameters

<div className="reference-table">
  | Field                                                          | Type     | Description         |
  | -------------------------------------------------------------- | -------- | ------------------- |
  | `fileId` <span className="required" title="required">\*</span> | `string` | The ID of the file. |
</div>

## Query parameters

<div className="reference-table">
  | Field                       | Type      | Description                                                                                                                                                                                                                                                                                |
  | --------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | `ignoreDefaultVisibility`   | `boolean` | Whether to ignore the domain's default visibility settings for the created file. Domain administrators can choose to make all uploaded files visible to the domain by default; this parameter bypasses that behavior for the request. Permissions are still inherited from parent folders. |
  | `keepRevisionForever`       | `boolean` | Whether to set the `keepForever` field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions.                                        |
  | `ocrLanguage`               | `string`  | A language hint for OCR processing during image import (ISO 639-1 code).                                                                                                                                                                                                                   |
  | `copyComments`              | `boolean` | Whether to copy the comments associated with the file.                                                                                                                                                                                                                                     |
  | `includePermissionsForView` | `string`  | Specifies which additional view's permissions to include in the response. Only `published` is supported.                                                                                                                                                                                   |
  | `includeLabels`             | `string`  | A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.                                                                                                                                                                                                |
  | `supportsAllDrives`         | `boolean` | Whether the requesting application supports both My Drives and shared drives.                                                                                                                                                                                                              |
</div>

## Body

<div className="reference-table">
  | Field                                                        | Type                                             | Description                                                                                                                                                                                     |
  | ------------------------------------------------------------ | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `file` <span className="required" title="required">\*</span> | [File](/charter/charter/packs/gdrive/files/objects#file) | The file resource to apply on the copy, with patch semantics. Typically `name` and optionally `parents`. If `parents` is omitted, the copy inherits any discoverable parent of the source file. |
</div>