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

> List a file's or shared drive's permissions.

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

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

result = await gdrive.permissions_list.ainvoke({"fileId": ...})
```

<Note>
  Requires `https://www.googleapis.com/auth/drive`. Pages by cursor: `nextPageToken` is sent back as `pageToken`. 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                                                                                                                                                                                                                                                                                                                                                             |
  | --------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `pageSize`                  | `integer` | The maximum number of permissions to return. The service may return fewer than this value. If unspecified, at most 100 permissions will be returned for shared drives, and the entire list of permissions for non-shared drives. The maximum value is 100; values above 100 will be coerced to 100. <span className="field-constraints">≥ 1; ≤ 100</span>               |
  | `pageToken`                 | `string`  | The token for continuing a previous list request on the next page. This should be set to the value of `nextPageToken` from the previous response.                                                                                                                                                                                                                       |
  | `includePermissionsForView` | `string`  | Specifies which additional view's permissions to include in the response. Only `published` is supported.                                                                                                                                                                                                                                                                |
  | `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>