Sign in

v3

latestOpenAPI 3.0.3MIT2026-07-313881,2455.6 MB
Database tables

Creates a job that creates a new table for the database related to the provided database_id parameter if the authorized user has access to the database's workspace. This endpoint is asynchronous and return the created job to track the progress of the task.

post/api/database/tables/database/{database_id}/async/

Path parameters

database_idinteger required

Creates a table for the database related to the provided value.

Headers

ClientSessionIdstring uuid

An optional header that marks the action performed by this request as having occurred in a particular client session. Then using the undo/redo endpoints with the same ClientSessionId header this action can be undone/redone.

Request body

namestring required
first_row_headerboolean

Indicates if the first provided row is the header. If true the field names are going to be the values of the first row. Otherwise they will be called "Field N"

importer_typestring

The frontend importer identifier used to parse the file.

original_file_namestring

The original name of the uploaded file.

Response

idinteger required
typestring required

The type of the job.

progress_percentageinteger required

A percentage indicating how far along the job is. 100 means that it's finished.

statestring required

Indicates the state of the import job.

human_readable_errorstring

A human readable error message indicating what went wrong.

created_onstring date-time required
updated_onstring date-time required
database_idinteger required

Database id where the table will be created.

namestring

The name of the new table.

table_idinteger

Table id where the data will be imported.

first_row_headerboolean
importer_typestring

The frontend importer identifier used to parse the file.

original_file_namestring

The original name of the uploaded file.