---
title: "Upload a CSV, Excel, or PDF file to an embed"
method: POST
path: "/v1/embeds/{embed_id}/upload"
tags: ["Headless Importer"]
---

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

`POST /v1/embeds/{embed_id}/upload`

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`.

## Path parameters

- `embed_id` integer, required

## Response `200`

200

- EmbedUploadResponse
  - `id` integer
  - `token` string
  - `status` string
  - `user_jwt` string

## Other responses

- `422` — 422

---

[API](https://skmtc.net/oneschema/apis/templates.md) · [All operations](https://skmtc.net/oneschema/apis/templates/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneschema/templates/versions/40674aa6d4d9/schema)