---
title: "Replace rows in batch in draft table"
method: POST
path: "/cms/hubdb/2026-03/tables/{tableIdOrName}/rows/draft/batch/replace"
tags: ["Rows"]
---

# Replace rows in batch in draft table

`POST /cms/hubdb/2026-03/tables/{tableIdOrName}/rows/draft/batch/replace`

Replaces multiple rows as a batch in the draft version of the table, with a maximum of 100 rows per call. See the endpoint `PUT /tables/{tableIdOrName}/rows/{rowId}/draft` for details on updating a single row.

## Path parameters

- `tableIdOrName` string, required

## Request body

- CmsHubdbBatchInputHubDbTableRowV3BatchUpdateRequest
  - `inputs` CmsHubdbHubDbTableRowV3BatchUpdateRequest[], required
    - `childTableId` integer, required — Specifies the value for the column child table id
    - `displayIndex` integer, required — The index position for displaying the row within the table.
    - `id` string — The id of the table row
    - `name` string — Specifies the value for `hs_name` column, which will be used as title in the dynamic pages
    - `path` string — Specifies the value for `hs_path` column, which will be used as slug in the dynamic pages
    - `values` object, required — List of key value pairs with the column name and column value

## Response `200`

successful operation

- CmsHubdbBatchResponseHubDbTableRowV3
  - `completedAt` string, date-time, required — The timestamp indicating when the batch processing was completed.
  - `links` object — A collection of related links associated with the batch response.
  - `requestedAt` string, date-time — The timestamp indicating when the batch request was made.
  - `results` CmsHubdbHubDbTableRowV3[], required
    - `childTableId` string, required — Specifies the value for the column child table id
    - `createdAt` string, date-time, required — Timestamp at which the row is created
    - `id` string, required — The id of the table row
    - `name` string, required — Specifies the value for `hs_name` column, which will be used as title in the dynamic pages
    - `path` string, required — Specifies the value for `hs_path` column, which will be used as slug in the dynamic pages
    - `publishedAt` string, date-time, required — The timestamp indicating when the row was last published, in date-time format.
    - `updatedAt` string, date-time, required — Timestamp at which the row is updated last time
    - `values` object, required — List of key value pairs with the column name and column value
  - `startedAt` string, date-time, required — The timestamp indicating when the batch processing began.
  - `status` 'CANCELED' | 'COMPLETE' | 'PENDING' | 'PROCESSING', required — The current status of the batch operation, with possible values: CANCELED, COMPLETE, PENDING, PROCESSING.

## Other responses

- `207` — multiple statuses
- `default` — An error occurred.

## Changes

> 14 revisions in range; 1 not diffed, 2 could not be searched.

- **2026-04-08** `b0d8bc008db9` — 1 info
  - api operation id `post-/cms/hubdb/2026-03/tables/{tableIdOrName}/rows/draft/batch/replace_replaceDraftTableRows` removed and replaced with `post-/cms/hubdb/2026-03/tables/{tableIdOrName}/rows/draft/batch/replace`
- **2026-04-01** `e0403341222c` — 2 warning, 1 info
  - removed the optional property `errors` from the response with the `200` status
  - removed the optional property `numErrors` from the response with the `200` status
  - added the success response with the status `207`
- **2026-03-30** `dc2fdad57f7f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hubspot/apis/hubspot-api-specification/changes/cms/hubdb/2026-03/tables/:tableIdOrName/rows/draft/batch/replace/post.md)

---

[API](https://skmtc.dev/hubspot/apis/hubspot-api-specification.md) · [All operations](https://skmtc.dev/hubspot/apis/hubspot-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hubspot/hubspot-api-specification/revisions/f9c7181056c5/schema)