---
title: "Permanently deletes rows"
method: POST
path: "/cms/hubdb/2026-03/tables/{tableIdOrName}/rows/draft/batch/purge"
tags: ["Rows"]
---

# Permanently deletes rows

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

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/cms/hubdb/2026-03/tables/{tableIdOrName}/rows/draft/batch/purge`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `hubdb`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `hubdb.rows.write`

Permanently deletes rows from the draft version of the table, given a set of row IDs. Maximum of 100 row IDs per call.

## Path parameters

- `tableIdOrName` string, required

## Request body

- BatchInputString
  - `inputs` string[], required: An array of strings representing the batch input values. Each item in the array is a string.

## Response `204`

No content

## Other responses

- `default`: An error occurred.

## Changes

- **2026-11-02** (2026-03) `57dfaa14c811`: 2 info
  - the security scope `hubdb` was added to the endpoint's security scheme `oauth2`
  - the security scope `hubdb.rows.write` was removed from the endpoint's security scheme `oauth2`
- **2026-09-10** (2026-03) `f907bc4f599c`: 2 info
  - the security scope `hubdb.rows.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `hubdb-data-write` was removed from the endpoint's security scheme `oauth2`
- **2026-09-09** (2026-03) `aae1075c6909`: 2 info
  - the security scope `hubdb-data-write` was added to the endpoint's security scheme `oauth2`
  - the security scope `hubdb.rows.write` was removed from the endpoint's security scheme `oauth2`
- **2026-09-07** (2026-03) `531201597da3`: 2 info
  - the security scope `hubdb` was added to the endpoint's security scheme `oauth2`
  - the security scope `hubdb.rows.write` was removed from the endpoint's security scheme `oauth2`
- **2026-09-04** (2026-03) `6b6a597c6598`: 2 info
  - the security scope `hubdb` was added to the endpoint's security scheme `oauth2`
  - the security scope `hubdb.rows.write` was removed from the endpoint's security scheme `oauth2`

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

---

[API](https://skmtc.dev/hubspot/apis/cms-hubdb.md) - [All operations](https://skmtc.dev/hubspot/apis/cms-hubdb/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/cms-hubdb/revisions/57dfaa14c811?raw)