---
title: Data deletion
description: Manage row-delete requests. These endpoints are only available in InfluxDB 3 Enterprise.
url: https://docs.influxdata.com/influxdb3/enterprise/api/data-deletion/
estimated_tokens: 879
product: InfluxDB 3 Enterprise
version: enterprise
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/enterprise/api/data-deletion/
---

[Download InfluxDB 3 Enterprise API Spec](/openapi/influxdb3-enterprise-openapi.yml)

Manage row-delete requests.

These endpoints are only available in InfluxDB 3 Enterprise.

POST`/api/v3/row_delete_requests/{seq}/abort`

### Abort a pending row-delete request

Aborts a pending row-delete request identified by its sequence number. Returns the updated request with a disposition of `aborted`.

Requires a token or user with `delete` permission on the database that the row-delete request targets.

This endpoint is only available in InfluxDB 3 Enterprise.

#### Parameters

##### Path parameters

`seq`requiredinteger \<int64\>

The sequence number of the row-delete request to abort.

#### Request bodyrequired

Content-Type:`application/json`

`reason`requiredstring

The reason for aborting the row-delete request.

Example request body

```json
{
  "reason": "Predicate was too broad"
}
```

Example request[Ask AI about this](#)

```sh
curl --request POST \
  "https://localhost:8181/api/v3/row_delete_requests/{seq}/abort" \
  --header "Authorization: Bearer INFLUX_TOKEN" \
  --header "Content-Type: application/json" \
  --data-raw '{"reason":"Predicate was too broad"}'
```

#### Responses

200Success. Returns the aborted row-delete request.

`abort_reason`string

The reason the request was aborted. Present only for aborted requests.

`aborted_at`integer \<int64\>

The Unix timestamp (seconds) when the request was aborted. Present only for aborted requests.

`completed_at`integer \<int64\>

The Unix timestamp (seconds) when the request completed. Present only for completed requests.

`created_at`requiredinteger \<int64\>

The Unix timestamp (seconds) when the request was created.

`db_id`requiredinteger \<int64\>

The numeric ID of the target database.

`db_name`requiredstring

The name of the target database.

`db_name_stale`requiredboolean

Whether the database name no longer matches the current catalog state for the stored database ID.

`delete_predicate`requiredstring

The predicate that selects rows to delete.

`disposition`requiredstring

The current disposition of the request: `pending`, `completed`, or `aborted`.

`max_time`integer \<int64\>

The maximum timestamp (nanoseconds) of the delete range.

`min_time`integer \<int64\>

The minimum timestamp (nanoseconds) of the delete range.

`progress`string

`sequence`requiredinteger \<int64\>

The sequence number of the row-delete request.

`table_id`requiredinteger \<int64\>

The numeric ID of the target table.

`table_name`requiredstring

The name of the target table.

`table_name_stale`requiredboolean

Whether the table name no longer matches the current catalog state for the stored table ID.

Example request body

```json
{
  "abort_reason": "Predicate was too broad",
  "aborted_at": 1717000100,
  "created_at": 1717000000,
  "db_id": 1,
  "db_name": "sensors",
  "db_name_stale": false,
  "delete_predicate": "room = 'kitchen'",
  "disposition": "aborted",
  "sequence": 42,
  "table_id": 3,
  "table_name": "home",
  "table_name_stale": false
}
```

400

Request failed. Possible reasons:

* Invalid database name
* Malformed request body
* Invalid timestamp precision

`data`object

`error`string

401Unauthorized access.

`data`object

`error`string

403Access denied.

`data`object

`error`string

404Not found. No row-delete request exists with the specified sequence number.

`data`object

`error`string

#### Related

* [InfluxDB 3 API client libraries](/influxdb3/enterprise/reference/client-libraries/v3/)