Delete table version records

Delete version metadata records for table id.

This operation deletes version tracking records, NOT the actual table data. It supports deleting ranges of versions for efficient bulk cleanup.

Special range values:

• start_version: 0 with end_version: -1 means delete ALL version records

POST /v1/table/{id}/version/delete

Error

A valid request URL is required to generate request examples

200

{
  "deleted_count": 1,
  "transaction_id": "<string>"
}

Authorizations

OAuth2BearerAuthApiKeyAuth

Authorization · string · header · required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

id · string · required

string identifier of an object in a namespace, following the Lance Namespace spec. When the value is equal to the delimiter, it represents the root namespace. For example, v1/namespace/$/list performs a ListNamespace on the root namespace.

Query Parameters

delimiter · string

An optional delimiter of the string identifier, following the Lance Namespace spec. When not specified, the $ delimiter must be used.

Body

application/json

Request to delete table version records. Supports deleting ranges of versions for efficient bulk cleanup.

ranges · object[] · required

List of version ranges to delete. Each range specifies start (inclusive) and end (exclusive) versions.

Show child attributes

identity · object

Identity information of a request.

Show child attributes

context · object

Arbitrary context for a request as key-value pairs. How to use the context is custom to the specific implementation.

REST NAMESPACE ONLY Context entries are passed via HTTP headers using the naming convention x-lance-ctx-<key>: <value>. For example, a context entry {"trace_id": "abc123"} would be sent as the header x-lance-ctx-trace_id: abc123.

Show child attributes

id · string[]

The table identifier

Response

200

application/json

Result of deleting table version records

Response for deleting table version records

deleted_count · integer<int64>

Number of version records deleted

Required range: x >= 0

transaction_id · string

Optional transaction identifier