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

# permissions_create

> Create a permission for a file or shared drive. `type` is `user`, `group`, `domain` or `anyone`; `role` is `owner`, `organizer`, `fileOrganizer`, `writer`, `commenter` or `reader`. For `user` or `group`, send `emailAddress`. Concurrent permission writes on the same file are not supported.

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

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

result = await gdrive.permissions_create.ainvoke({"fileId": ..., "permission": ...})
```

<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 or shared drive. |
</div>

## Query parameters

<div className="reference-table">
  | Field                   | Type      | Description                                                                                                                                                                                                                                                                                                                                                             |
  | ----------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `emailMessage`          | `string`  | A plain text custom message to include in the notification email.                                                                                                                                                                                                                                                                                                       |
  | `sendNotificationEmail` | `boolean` | Whether to send a notification email when sharing to users or groups. This defaults to `true` for users and groups, and is not allowed for other requests. It must not be disabled for ownership transfers.                                                                                                                                                             |
  | `transferOwnership`     | `boolean` | Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect. For more information, see Transfer file ownership.                                                                                                                                                |
  | `moveToNewOwnersRoot`   | `boolean` | This parameter only takes effect if the item isn't in a shared drive and the request is attempting to transfer the ownership of the item. If set to `true`, the item is moved to the new owner's My Drive root folder and all prior parents removed. If set to `false`, parents aren't changed.                                                                         |
  | `useDomainAdminAccess`  | `boolean` | Issue the request as a domain administrator. If set to `true`, and if the following additional conditions are met, the requester is granted access: (1) The file ID parameter refers to a shared drive. (2) The requester is an administrator of the domain to which the shared drive belongs. For more information, see Manage shared drives as domain administrators. |
  | `supportsAllDrives`     | `boolean` | Whether the requesting application supports both My Drives and shared drives.                                                                                                                                                                                                                                                                                           |
</div>

## Body

<div className="reference-table">
  | Field                                                              | Type                                                               | Description               |
  | ------------------------------------------------------------------ | ------------------------------------------------------------------ | ------------------------- |
  | `permission` <span className="required" title="required">\*</span> | [Permission](/charter/charter/packs/gdrive/permissions/objects#permission) | The permission to create. |
</div>