---
title: "Import an embed file"
method: POST
path: "/v1/embeds/{embed_id}/import"
tags: ["Headless Importer"]
---

# Import an embed file

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

Import the validated embed file. The import behavior is defined by the [import_config](https://docs.oneschema.co/docs/importing-validated-data) 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`.

## Path parameters

- `embed_id` integer, required

## Response `200`

200

- EmbedDetail
  - `id` integer
  - `token` string
  - `template_key` string
  - `status` string
  - `user_jwt` string
  - `imported_row_count` integer — Total number of imported rows. Only present when the embed status is "imported".

## 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)