Data deletion

Download InfluxDB 3 Enterprise API Spec

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 required integer <int64>
The sequence number of the row-delete request to abort.

Request body required

Content-Type: application/json
reason required string
The reason for aborting the row-delete request.
Example request body
{
  "reason": "Predicate was too broad"
}
Example request Ask AI about this
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

200 Success. 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 required integer <int64>
The Unix timestamp (seconds) when the request was created.
db_id required integer <int64>
The numeric ID of the target database.
db_name required string
The name of the target database.
db_name_stale required boolean
Whether the database name no longer matches the current catalog state for the stored database ID.
delete_predicate required string
The predicate that selects rows to delete.
disposition required string
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 required integer <int64>
The sequence number of the row-delete request.
table_id required integer <int64>
The numeric ID of the target table.
table_name required string
The name of the target table.
table_name_stale required boolean
Whether the table name no longer matches the current catalog state for the stored table ID.
Example request body
{
  "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
401 Unauthorized access.
data object
error string
403 Access denied.
data object
error string
404 Not found. No row-delete request exists with the specified sequence number.
data object
error string

Was this page helpful?

Thank you for your feedback!