v1

latestOpenAPI 3.0.2Apache 2.02026-07-17212942.1 KB

Tables

Create a table in a namespace

Create a table or start a create transaction

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

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)

X-Iceberg-Access-Delegation'vended-credentials' | 'remote-signing'

Optional signal that the client wants the server to return access credentials

namestring required

Table name

locationstring

Table location. If not specified, the location will be computed by the catalog

stage-createboolean

If true, create the table as staged. The table will not be visible until it is committed

propertiesobject

Table created successfully

metadata-locationstring

Location of the metadata file

configobject

Configuration for accessing the table