---
title: "Changes to executeMapping"
method: POST
path: "/v1/mappings:execute"
---

# Changes to executeMapping

`POST /v1/mappings:execute`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 7 revisions.

- **2026-10-09** `4ae173185b5d`: 6 breaking, 5 warning, 7 info
- **2026-09-15** `66782a6e34d5`: 4 info
- **2026-09-10** `82835dfd8535`: 2 info
- **2026-08-31** `f9ced0ac8505`: 2 info
- **2026-08-12** `ac038dfc97a1`: 2 info

## Changes

- **2026-10-09** `4ae173185b5d`: 6 breaking, 5 warning, 7 info
  - added `#/components/schemas/EntityRef` to the `loop_ref` request property `allOf` list
  - added `#/components/schemas/EntityRef` to the `source_ref` request property `allOf` list
  - added `#/components/schemas/RandomOperation` to the `targets/items/mapping_attributes/items/anyOf[#/components/schemas/MappingAttributeV2]/operation/oneOf[#/components/schemas/OperationObjectNode]/_random` request property `allOf` list
  - removed `subschema #1, subschema #2` from the `targets/items/mapping_attributes/items/anyOf[#/components/schemas/MappingAttributeV2]/operation/oneOf[#/components/schemas/OperationObjectNode]/_random` request property `oneOf` list
  - the `loop_ref` request property type changed from `object` to no type
  - the `source_ref` request property type changed from `object` to no type
  - removed the request property `loop_ref/entity_id`
  - removed the request property `loop_ref/entity_schema`
  - removed the request property `source_ref/entity_id`
  - removed the request property `source_ref/entity_schema`
  - removed the optional property `mapped_entities/items/required` from the response with the `200` status
  - added `#/components/schemas/RandomOperation` to the `failures/items/target/mapping_attributes/items/anyOf[#/components/schemas/MappingAttributeV2]/operation/oneOf[#/components/schemas/OperationObjectNode]/_random` response property `allOf` list for the response status `200`
  - the response property `mapped_entities/items/_created_at` became required for the status `200`
  - the response property `mapped_entities/items/_id` became required for the status `200`
  - the response property `mapped_entities/items/_org` became required for the status `200`
  - the response property `mapped_entities/items/_schema` became required for the status `200`
  - the response property `mapped_entities/items/_updated_at` became required for the status `200`
  - removed `subschema #1, subschema #2` from the `failures/items/target/mapping_attributes/items/anyOf[#/components/schemas/MappingAttributeV2]/operation/oneOf[#/components/schemas/OperationObjectNode]/_random` response property `oneOf` list for the response status `200`
- **2026-09-15** `66782a6e34d5`: 4 info
  - added the new optional request property `targets/items/loop_config/filter_tags`
  - added the new optional request property `targets/items/loop_config/source_type`
  - added the optional property `failures/items/target/loop_config/filter_tags` to the response with the `200` status
  - added the optional property `failures/items/target/loop_config/source_type` to the response with the `200` status
- **2026-09-10** `82835dfd8535`: 2 info
  - added the new optional request property `targets/items/graph_context/items/graph/nodes/items/optional`
  - added the optional property `failures/items/target/graph_context/items/graph/nodes/items/optional` to the response with the `200` status
- **2026-08-31** `f9ced0ac8505`: 2 info
  - added the new optional request property `targets/items/graph_context`
  - added the optional property `failures/items/target/graph_context` to the response with the `200` status
- **2026-08-12** `ac038dfc97a1`: 2 info
  - added the new optional request property `targets/items/use_uniqueness_criteria`
  - added the optional property `failures/items/target/use_uniqueness_criteria` to the response with the `200` status

---

[Operation](https://skmtc.dev/epilot/apis/entity-mapping-api/docs/v1/mappings:execute/post.md) - [API](https://skmtc.dev/epilot/apis/entity-mapping-api.md) - [Page](https://skmtc.dev/epilot/apis/entity-mapping-api/changes/v1/mappings:execute/post)