v1

latestOpenAPI 3.0.2Apache 2.02026-07-17212942.1 KB
Tables

Commit updates to a table

Commit updates to a table. Commits can optionally include requirements that must be satisfied for the commit to succeed. If any requirement is not met, the commit will fail with a 409 Conflict response.

post/apis/iceberg/v1/{prefix}/namespaces/{namespace}/tables/{table}

Path parameters

prefixstring required

An optional prefix to use for the catalog. A prefix can be used to distinguish between multiple catalogs

namespacestring required

A namespace identifier as a URL-encoded concatenation of namespace levels, separated by the null byte (0x00)

tablestring required

A table name

Request body

requirementsobject[] required

Requirements that must be met for the commit to succeed. Each requirement has a 'type' field indicating the assertion type.

updatesobject[] required

Updates to apply to the table metadata. Each update has an 'action' field indicating the update type.

Response

Table updated successfully

metadata-locationstring

Location of the metadata file

configobject

Configuration for accessing the table