Skip to main content
POST
Save a Table

Authorizations

Authorization
string
header
required

Microsoft Entra application token issued by the caller's Organization tenant for this multitenant API. Request the .default scope and assign the application the required GV.APIReader, GV.APIContributor, or GV.APIOwner role.

Body

application/json
format
string
required

Always delta.

Allowed value: "delta"
lakehouse_id
string<uuid>
required

The Lakehouse's item ID.

name
string
required

The Table's name in General Validation.

Required string length: 1 - 255
Pattern: ^[^\x00-\x1f\x7f]+$
path
string
required

The Table's path in the Lakehouse: Tables/<table>, or Tables/<schema>/<table> in a Lakehouse with schemas.

Required string length: 1 - 512
workspace_id
string<uuid>
required

The Fabric workspace that holds the Lakehouse.

kind
string
default:lakehouse

lakehouse, or omit it.

Allowed value: "lakehouse"
options
Options · object

Delta tables accept only an empty options object.

version_as_of
integer | null

Read this Delta table version at every Run. Omit to read the latest version.

Required range: 0 <= x <= 9007199254740991

Response

Successful Response

format
string
required

Always delta.

Allowed value: "delta"
id
string<uuid>
required
lakehouse_id
string<uuid>
required

The Lakehouse's item ID.

name
string
required

The Table's name in General Validation.

Required string length: 1 - 255
Pattern: ^[^\x00-\x1f\x7f]+$
path
string
required

The Table's path in the Lakehouse: Tables/<table>, or Tables/<schema>/<table> in a Lakehouse with schemas.

Required string length: 1 - 512
workspace_id
string<uuid>
required

The Fabric workspace that holds the Lakehouse.

kind
string
default:lakehouse

lakehouse, or omit it.

Allowed value: "lakehouse"
options
Options · object

Delta tables accept only an empty options object.

version_as_of
integer | null

Read this Delta table version at every Run. Omit to read the latest version.

Required range: 0 <= x <= 9007199254740991