v1

latestOpenAPI 3.1.0proprietary2026-07-24156175241.3 KB

Headless Importer

Import an embed file

Import the validated embed file. The import behavior is defined by the import_config object used to initialized the embed. An embed must be in the columns_mapped state to enable import, and an embed is returned in one of the following states depending on import config: import-pending or imported.

post/v1/embeds/{embed_id}/import

Path parameters

embed_idinteger required

The id of the embed which contains the file.

Response

200

idinteger

tokenstring

template_keystring

statusstring

user_jwtstring

imported_row_countinteger

Total number of imported rows. Only present when the embed status is "imported".

Example response

{
  "id": 41559,
  "token": "5fd6a161-86f1-4514-9e92-0660e19ad5c2",
  "template_key": "employees",
  "status": "columns_mapped",
  "user_jwt": "REPLACE_WITH_JWT",
  "imported_row_count": 995
}