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

# drives_list

> List the user's shared drives. `q` is Drive's shared-drive search grammar.

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

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

result = await gdrive.drives_list.ainvoke({})
```

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

## Query parameters

<div className="reference-table">
  | Field                  | Type      | Description                                                                                                                                                                                                                                                                      |
  | ---------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `q`                    | `string`  | Query string for searching shared drives.                                                                                                                                                                                                                                        |
  | `pageSize`             | `integer` | The maximum number of shared drives to return. The service may return fewer than this value. If unspecified, at most 10 shared drives will be returned. 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.                                                                                                                                |
  | `useDomainAdminAccess` | `boolean` | Issue the request as a domain administrator; if set to true, then all shared drives of the domain in which the requester is an administrator are returned.                                                                                                                       |
</div>