---
title: "Create a staging table"
method: POST
path: "/staging-tables"
tags: ["Tables"]
---

# Create a staging table

`POST /staging-tables`

## Request

- Base URL: `http://localhost:8080/api/2.1/unity-catalog`
- URL: `http://localhost:8080/api/2.1/unity-catalog/staging-tables`
- Auth: none declared

Creates a new staging table instance. Staging tables are used during managed table creation. Creating a managed
table requires performing two actions – initializing the table data in cloud storage and creating the named
table entry in the catalog – and these should appear as an atomic operation to other operations on catalog
tables. A staging table is used to allocate storage for the managed table, and the catalog_name.schema_name.name
parameters provided in this request are used to initialize any required storage properties and determine the
storage URL that should be used for the data contained by this table.

Temporary credentials can be obtained as though the staging table were a regular table to get access to the
staging table’s storage. After the table’s data is initialized, the staging table is “promoted” to a managed
table by creating a managed table with the same location as the staging table. This allows for the atomic
creation of a managed table that already has full data written to its storage location. Note: the name provided
must match the name used to initialize the staging table originally.

WARNING: This API is experimental and may change in future versions.

## Request body

- CreateStagingTable
  - `name` string, required: Name of table, relative to parent schema.
  - `catalog_name` string, required: Name of parent catalog.
  - `schema_name` string, required: Name of parent schema relative to its parent catalog.

## Response `200`

The new staging table was successfully created.

- StagingTableInfo
  - `name` string: Name of table, relative to parent schema.
  - `catalog_name` string: Name of parent catalog.
  - `schema_name` string: Name of parent schema relative to its parent catalog.
  - `id` string: Unique identifier for the table.
  - `staging_location` string: URI generated for the staging table

## Changes

- **2025-10-29** `09f1756ade44`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/changes/staging-tables/post.md)

---

[API](https://skmtc.dev/unitycatalog/apis/unity-catalog-api.md) - [All operations](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unitycatalog/apis/unity-catalog-api/revisions/c84507f0d7e0?raw)