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

# spreadsheets_sheets_copy_to

> Copy a single sheet from one spreadsheet to another. Returns the properties of the newly created sheet in the destination spreadsheet.

<div className="tool-route"><span className="tool-row-method" data-method="POST">POST</span><code>{"https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/sheets/{sheetId}:copyTo"}</code></div>

```python gsheets_spreadsheets_sheets_copy_to.py theme={null}
from charter.packs import gsheets

result = await gsheets.spreadsheets_sheets_copy_to.ainvoke({"spreadsheetId": ..., "sheetId": ..., "body": ...})
```

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

## Path parameters

<div className="reference-table">
  | Field                                                                 | Type      | Description                                             |
  | --------------------------------------------------------------------- | --------- | ------------------------------------------------------- |
  | `spreadsheetId` <span className="required" title="required">\*</span> | `string`  | The ID of the spreadsheet containing the sheet to copy. |
  | `sheetId` <span className="required" title="required">\*</span>       | `integer` | The ID of the sheet to copy.                            |
</div>

## Body

<div className="reference-table">
  | Field                                                        | Type                                                                                                                     | Description                  |
  | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ---------------------------- |
  | `body` <span className="required" title="required">\*</span> | [CopySheetToAnotherSpreadsheetRequest](/charter/charter/packs/gsheets/spreadsheets/objects#copysheettoanotherspreadsheetrequest) | The destination spreadsheet. |
</div>
