Skip to main content
POST
Create table import

Authorizations

Authorization
string
header
required

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

Scopes

agent:write

agent:write

Query Parameters

confirm
boolean
default:false

Required (true) when import_type is FULL_REFRESH or INCREMENTAL_REFRESH — both replace the existing table's rows.

Body

application/json
asset_id
string
required
Minimum string length: 1
table_name
string
required
Minimum string length: 1
import_type
enum<string>
default:NEW

How the asset is applied: 'NEW' imports it into a new table and refuses a name that already exists; 'FULL_REFRESH' and 'INCREMENTAL_REFRESH' re-import the full asset into a previously imported table, replacing its rows — for file imports the two are equivalent today (neither appends), and both require confirm=true. Case-insensitive.

Available options:
NEW,
FULL_REFRESH,
INCREMENTAL_REFRESH
column_mappings
TableImportColumnMapping · object[]
csv
CsvParsingInfoRequest · object | null
include_load_date
boolean
default:false

Response

Successful Response