Skip to main content
POST
Clone Table

Overview

This endpoint duplicates an existing table configuration, with optional schema-only cloning.

Example request

Key parameters

  • table_id (required): source table identifier.
  • schema_only (optional): defaults to false; set true to clone structure without data.

Success signal

A successful response includes a new table id.

Common errors

401 Unauthorized

Check that your header is Authorization: Bearer ${EXTRUCT_API_TOKEN}.

404 Not Found

The source table ID is invalid or unavailable in your workspace.

422 Unprocessable Entity

Most often caused by invalid schema_only query value.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

table_id
string
required

Query Parameters

schema_only
boolean
default:false

Response

Successful Response

id
string
required

Table ID.

created_at
string<date-time>
required

Table creation time.

name
string
required

Table name.

kind
enum<string>
required

Table type.

Available options:
generic,
company,
people
columns
ColumnOutputSchema · object[]
required

Table columns configurations.

owner
OwnerInfo · object
required
description
string | null

Table description.

tags
string[] | null

Table tags.

child_relationships
TableRelationshipOutput · object[]

Child table relationships.

parent_relationships
TableRelationshipOutput · object[]

Parent table relationships.