---
title: "Tell us what you kept of a suggested mapping (column names and field names only, never a value) — it improves the next suggestions"
method: POST
path: "/api/v1/mappings/{formId}/outcome"
tags: ["Automation"]
---

# Tell us what you kept of a suggested mapping (column names and field names only, never a value) — it improves the next suggestions

`POST /api/v1/mappings/{formId}/outcome`

## Request

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

## Path parameters

- `formId` string, required

## Request body

- object
  - `proposer` 'model' | 'name' | 'saved' | 'identity'
  - `proposed` object[]
    - `header` string
    - `parameter` string
  - `kept` object[]
    - `header` string
    - `parameter` string, nullable
  - `unfed_required` string[]

## Response `200`

{ is_recorded, kept_count, changed_count, dropped_count, added_count }

## Other responses

- `404`: No such 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)