> ## 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_create

> Create a file's metadata: a folder (`mimeType` `application/vnd.google-apps.folder`), a Google Doc / Sheet / Slide, or an empty blob. Media upload is not expressed here. `parents` takes at most one folder ID.

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

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

result = await gdrive.files_create.ainvoke({"file": ...})
```

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

## 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).                                                                                                                                                                                                                   |
  | `useContentAsIndexableText` | `boolean` | Whether to use the uploaded content as indexable text.                                                                                                                                                                                                                                     |
  | `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 create. For a folder, set `mimeType` to `application/vnd.google-apps.folder`. For a Google Doc, Sheet or Slide, use the corresponding `application/vnd.google-apps.*` MIME type. `parents` takes at most one folder ID. |
</div>