Skip to main content
POST
/
v1
/
table
/
{id}
/
create
Create a table with the given name
curl --request POST \
  --url {scheme}://{host}:{port}/{basePath}/v1/table/{id}/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.apache.arrow.stream' \
  --data '"<string>"'
{
  "transaction_id": "<string>",
  "location": "<string>",
  "version": 1,
  "storage_options": {},
  "properties": {
    "owner": "Ralph",
    "created_at": "1452120468"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.lancedb.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
id
string
required

string identifier of an object in a namespace, following the Lance Namespace spec. When the value is equal to the delimiter, it represents the root namespace. For example, v1/namespace/$/list performs a ListNamespace on the root namespace.

Query Parameters

​
delimiter
string

An optional delimiter of the string identifier, following the Lance Namespace spec. When not specified, the $ delimiter must be used.

​
mode
string
​
properties
string

Business logic properties managed by the namespace implementation outside Lance context. The map is translated to a single JSON-encoded query parameter such as properties={"user":"alice","team":"eng"}.

​
storage_options
string

Storage options that configure overrides for writing table data and metadata during table creation. These are passed to Lance for the write path. The map is translated to a single JSON-encoded query parameter such as storage_options={"aws_region":"us-east-1","timeout":"30s"}.

Body

application/vnd.apache.arrow.stream

Arrow IPC data

The body is of type file.

Response

Table properties result when creating a table

​
transaction_id
string

Optional transaction identifier

​
location
string
​
version
integer<int64>
Required range: x >= 0
​
storage_options
object

Configuration options to be used to access storage. The available options depend on the type of storage in use. These will be passed directly to Lance to initialize storage access.

​
properties
object

Business logic properties stored and managed by the namespace implementation outside Lance context. If the implementation does not support table properties, it should return null for this field.

Example:
{
  "owner": "Ralph",
  "created_at": "1452120468"
}