v1

latestOpenAPI 3.1.0proprietary2026-07-24156175241.3 KB

Headless Importer

Set header row on an embed file

Set the header row either automatically or by index on an embed file. An embed must be in the uploaded state to enable setting headers, and an embed is returned in one of the following states: headers_set or columns_mapped.

post/v1/embeds/{embed_id}/set-header

Path parameters

embed_idinteger required

The id of the embed which contains the file.

Request body

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
}