# Copy rows to another sheet

Copies rows from the sheet specified in the URL to (the bottom of) another sheet.

Endpoint: POST /sheets/{sheetId}/rows/copy
Version: 2.0.0
Security: APIToken, OAuth2

## Path parameters:

  - `sheetId` (number, required)
    ID of the sheet being accessed.

## Header parameters:

  - `Authorization` (string)
    API Access Token used to authenticate requests to Smartsheet APIs.

  - `smartsheet-integration-source` (string)
    Uses the following metadata to distinguish between human-initiated API requests and third-party service-initiated calls by AI Connectors or ITSM:

- Integration source type
- Organization name
- Integration source name 

Format:


TYPE,OrgName,SourceName


Examples: 

AI,SampleOrg,My-AI-Connector-v2

SCRIPT,SampleOrg2,Accounting-updater-script

APPLICATION,SampleOrg3,SheetUpdater
    Example: "AI,SampleOrg,My-AI-Connector-v2"

  - `Content-Type` (string)
    Required for POST and PUT requests. Defines the structure for the request body.

## Query parameters:

  - `include` (string)
    A comma-separated list of row elements to copy in addition to the cell data:
  * all - specify a value of all to include everything (attachments, children, and discussions).
  * attachments
  * children -  if specified, any child rows of the rows specified in the request are also copied to the destination sheet, and parent-child relationships amongst rows are preserved within the destination sheet; if not specified, only the rows specified in the request are copied.
  * discussions
    Enum: "all", "attachments", "children", "discussions"

  - `ignoreRowsNotFound` (boolean)
    true or false: default is false. If set to true, specifying row Ids that do not exist within the source sheet does not cause an error response. If omitted or set to false, specifying row Ids that do not exist within the source sheet causes an error response (and no rows are copied).

## Request fields (application/json):

  - `rowIds` (array)
    The Ids of the rows to move or copy from the source sheet.

  - `to` (object)

  - `to.sheetId` (number)
    The ID of the destination sheet.

## Response 200 fields (application/json):

  - `destinationSheetId` (number)
    The ID of the destination sheet.

  - `rowMappings` (array)
    Array of rowMapping objects.

  - `rowMappings.from` (number)
    Row ID in the source sheet.

  - `rowMappings.to` (number)
    Row ID in the destination sheet.