Document apiReferenceTables

tables.moveRow

Move a row to a new position within the same table. Available on v2-backed sessions only; v1-backed sessions currently return `CAPABILITY_UNAVAILABLE`.

mutates documentdry runconditional
doc.tables.moveRow(…)

Expected result

Returns a TableMutationResult receipt; reports NO_OP if the row is already at the requested position.

Inputs

Variant 1
targetTableRowAddressrequired
Fields
kind"block"required
nodeType"tableRow"required
nodeIdstringrequired
destinationfirst | last | before | after | before | after | before | afterrequired
first
kind"first"required
last
kind"last"required
before
kind"before"required
rowIndexintegerrequired
after
kind"after"required
rowIndexintegerrequired
before
kind"before"required
targetTableRowAddressrequired
Fields
kind"block"required
nodeType"tableRow"required
nodeIdstringrequired
after
kind"after"required
targetTableRowAddressrequired
Fields
kind"block"required
nodeType"tableRow"required
nodeIdstringrequired
before
kind"before"required
nodeIdstringrequired
after
kind"after"required
nodeIdstringrequired
Variant 2
targetTableAddressrequired
Fields
kind"block"required
nodeType"table"required
nodeIdstringrequired
rowIndexintegerrequired
destinationfirst | last | before | after | before | after | before | afterrequired
first
kind"first"required
last
kind"last"required
before
kind"before"required
rowIndexintegerrequired
after
kind"after"required
rowIndexintegerrequired
before
kind"before"required
targetTableRowAddressrequired
Fields
kind"block"required
nodeType"tableRow"required
nodeIdstringrequired
after
kind"after"required
targetTableRowAddressrequired
Fields
kind"block"required
nodeType"tableRow"required
nodeIdstringrequired
before
kind"before"required
nodeIdstringrequired
after
kind"after"required
nodeIdstringrequired
Variant 3
nodeIdstringrequired
rowIndexintegerrequired
destinationfirst | last | before | after | before | after | before | afterrequired
first
kind"first"required
last
kind"last"required
before
kind"before"required
rowIndexintegerrequired
after
kind"after"required
rowIndexintegerrequired
before
kind"before"required
targetTableRowAddressrequired
Fields
kind"block"required
nodeType"tableRow"required
nodeIdstringrequired
after
kind"after"required
targetTableRowAddressrequired
Fields
kind"block"required
nodeType"tableRow"required
nodeIdstringrequired
before
kind"before"required
nodeIdstringrequired
after
kind"after"required
nodeIdstringrequired

Result

Output fields
true
successtruerequired
tableTableAddress
Fields
kind"block"required
nodeType"table"required
nodeIdstringrequired
trackedChangeRefsEntityAddress[]
false
successfalserequired
failureobjectrequired
Fields
code"NO_OP" | "INVALID_TARGET" | "TARGET_NOT_FOUND" | "CAPABILITY_UNAVAILABLE"required
messagestringrequired
detailsunknown

Failures

Pre-apply throws

  • TARGET_NOT_FOUND
  • INVALID_TARGET
  • CAPABILITY_UNAVAILABLE
1 more codes
  • INVALID_TARGET

Non-applied receipt codes

  • INVALID_TARGET
  • NO_OP
  • CAPABILITY_UNAVAILABLE

Raw schemas

Open the generated JSON artifact for the exact input, output, success, and failure schemas represented by this contract version.

View raw JSON schemas