---
title: "Save the mapping for a header row: batches, schedules and recipes with these columns then map with no model call"
method: PUT
path: "/api/v1/mappings/{formId}"
tags: ["Automation"]
---

# Save the mapping for a header row: batches, schedules and recipes with these columns then map with no model call

`PUT /api/v1/mappings/{formId}`

## Request

- Base URL: `https://philforms.com`
- URL: `https://philforms.com/api/v1/mappings/{formId}`
- Auth: HTTP bearer

## Path parameters

- `formId` string, required

## Request body

- object
  - `header` string[], required
  - `mapping` object[], required
    - `header` string
    - `parameter` string

## Response `200`

{ mapping, mapped_column, unmapped_column, unfed_parameter }

## Other responses

- `400`: No pair names a column and a parameter
- `404`: Unknown form

---

[API](https://skmtc.dev/philforms/apis/philforms-api.md) · [All operations](https://skmtc.dev/philforms/apis/philforms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/philforms/apis/philforms-api/revisions/a43bf313729c?raw)
