---
title: "Set column mapping on an embed file"
method: POST
path: "/v1/embeds/{embed_id}/map"
tags: ["Headless Importer"]
---

# Set column mapping on an embed file

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

Set column mapping for an embed file. Mapping strategy can be defined in customizations. An embed must be in the `headers_set` state to support column mapping, and an embed is returned in `columns_mapped` state.

## Path parameters

- `embed_id` integer, required

## Request body

- SetColumnMappingRequest
  - `overrides` MappingOverride[] — These mappings will override detected mappings. Either column_id or column_name must be specified. If template_column_key is null, the column will not be mapped.
    - `column_id` integer — The id of the sheet column.
    - `column_name` string — The label of the sheet column.
    - `template_column_key` string, nullable, required — The key of the template column, or null to unmap the column.

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