View as Markdown
Smartsheet icon

Smartsheet ACTION

Move Rows

Move rows from one sheet to another. WARNING: the rows are permanently removed from the source sheet. Cell values and formatting always come across; attachments and comments only if you ask for them via Include. Columns the destination sheet is missing are created automatically, so it does not have to match the source first. Returns rowMappings pairing each source row ID with its new ID in the destination. To keep the originals, use Copy Rows. See the documentation
  • Action
  • Writes data
  • Destructive
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Smartsheet account once, then configure and run Move Rows from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "smartsheet-move-rows",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    smartsheet: { authProvisionId: "apn_xxxxxxx" },
    sheetId: "Source Sheet ID or URL",
    rowIds: "Row IDs",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Move Rows inputs
Property Type Description
sheetId Source Sheet ID or URL string
The sheet the rows are moved out of. Accepts a numeric sheet ID (e.g. 1234567890123456), or a Smartsheet sheet URL, which is resolved to the ID for you. Use List Sheets to enumerate sheets, or Search to find one by name.
Required
rowIds Row IDs string
Comma-separated list of row IDs to move, or a JSON array. Example: 1234567890, 9876543210 or [1234567890, 9876543210]. Use Get Sheet to find row IDs.
Required
destinationSheetId Destination Sheet ID or URL string
The sheet the rows are moved into. Accepts a numeric sheet ID (e.g. 1234567890123456), or a Smartsheet sheet URL, which is resolved to the ID for you. Use List Sheets to enumerate sheets, or Search to find one by name.
Required
include Include string[]
Extra elements to carry across. Without this, only cell values and formatting are moved; attachments and comments are not. Move Rows supports only attachments and discussions - the children and all values that Copy Rows accepts are not available for this endpoint.
Optional
ignoreRowsNotFound Ignore Rows Not Found boolean
true to skip row IDs that do not exist in the source sheet. Default false, which fails the whole call with a 404 if any ID is missing.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
smartsheet-move-rows
Version
0.1.1
App
Smartsheet
Authentication
OAuth
Read-only
No
Destructive
Yes
Open world
Yes