v1

latestOpenAPI 3.1.0proprietary2026-07-24156175241.3 KB
Headless Importer

Upload a CSV, Excel, or PDF file to an embed

Upload a CSV (.csv), Excel (.xlsx), or PDF (.pdf) file into OneSchema. PDF uploads are accepted when PDF extraction is enabled for the embed's organization. An embed must be in the initialized state to support an upload, and an embed is returned in one of the following states: uploaded, headers_set, or columns_mapped.

post/v1/embeds/{embed_id}/upload

Path parameters

embed_idinteger required

The id of the embed which contains the file.

Response

200

idinteger
tokenstring
statusstring
user_jwtstring

Example response

{
  "id": 41963,
  "token": "812f66e4-76c3-4e1e-9e85-5c1374f15c6a",
  "status": "uploaded",
  "user_jwt": "REPLACE_WITH_JWT"
}