Skip to main content
POST
/
v1
/
tables
/
{table}
/
rows
/
delete
cURL
curl --request POST \
  --url https://api.botpress.cloud/v1/tables/{table}/rows/delete \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-bot-id: <x-bot-id>' \
  --data '
{
  "ids": [
    123
  ],
  "filter": {},
  "deleteAllRows": true
}
'
{
  "deletedRows": 123,
  "job": {
    "id": "<string>",
    "status": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-bot-id
string
required

Bot id

​
x-integration-id
string

Integration id

​
x-integration-alias
string

Integration alias

​
x-integration-name
string

Integration name

​
x-user-id
string

User Id

​
x-user-role
string

User Role

Path Parameters

​
table
string
required

The table's name or unique identifier for targeting specific table operations.

Body

application/json

Identifiers of the rows to be deleted.

​
ids
number[]
Maximum array length: 1000
Required range: x <= 2147483647
​
filter
object

Filter to apply when deleting rows. Deletion with a filter is performed asynchronously in batches and returns a job object to track progress. Example: { "createdAt": { "$lt": "2026-01-01" } }

​
deleteAllRows
boolean

Flag to delete all rows. Use with caution as this action is irreversible.

Response

Confirms the number of rows successfully deleted. When using a filter, returns a job object for tracking async progress.

​
deletedRows
number
required
​
job
object
Last modified on March 18, 2026