LAlakekeeper
warehouse

Update Format Version Policy

Configures which Iceberg table format versions may be created in, or upgraded to, within a warehouse, and the default version applied when a create-table request does not specify one.

post/management/v1/warehouse/{warehouse_id}/format-version-policy

Request

Path parameters

warehouse_idstring uuid required

Request body

allowed-format-versionsinteger[] required

Iceberg table format versions that may be created in, or upgraded to, within this warehouse. Must be a non-empty subset of [1, 2, 3].

default-format-versioninteger nullable

Default Iceberg table format version applied when a create-table request does not specify one. Must be a member of allowed-format-versions. When omitted, resolves to v2 if allowed, otherwise the highest allowed version.

Response

Format version policy updated successfully

allowed-format-versionsinteger[] required

Iceberg table format versions that may be created in, or upgraded to, within this warehouse.

default-format-versioninteger nullable

Default Iceberg table format version applied when a create-table request does not specify one. When absent, resolves to v2 if allowed, otherwise the highest allowed version.

idstring uuid required

ID of the warehouse.

managed-by'self-managed' | 'instance-admin'

Which control plane, if any, exclusively manages a warehouse's spec.

self-managed (the default) leaves the spec mutable by the warehouse's own owners through the usual grants. When set to instance-admin, spec changes — storage profile, credentials, delete profile, rename, status, protection, format-version policy, and deletion — are accepted only from instance administrators; other callers are rejected even when their grants would otherwise allow it. Child resources (namespaces, tables, grants), task-queue configuration, and data access are unaffected.

namestring required

Name of the warehouse.

project-idstring required

Project ID in which the warehouse was created.

protectedboolean required

Whether the warehouse is protected from being deleted.

status'active' | 'inactive' required

Status of a warehouse

updated-atstring date-time nullable

Last updated timestamp.

warehouse-idstring uuid required

ID of the warehouse.

Example response

{
  "storage-profile": {
    "storage-layout": {
      "tabular": "{name}-{uuid}"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.