---
title: "Validate a single entity dynamic mapping with a dry-run"
method: POST
path: "/api/v1/entity_dynamic_mappings/dry-run"
tags: ["Entity dynamic mapping"]
---

# Validate a single entity dynamic mapping with a dry-run

`POST /api/v1/entity_dynamic_mappings/dry-run`

Validate one JSLT mapping definition against a sample payload and target template identifier without persisting any data

## Request body

- EntityDynamicMappingDryRunDtoIn — Request payload for a single entity dynamic mapping dry-run validation
  - `mapping` EntityDynamicMappingCreateDtoIn, required
    - `identifier` string, required
    - `entity_template_identifier` string, required
    - `filter` string, required
    - `action` 'UPDATE_ENTITY' | 'UPDATE_PROPERTIES' | 'UPDATE_RELATIONS' | 'DELETE_ENTITY', required
    - `name` string, required
    - `description` string
    - `entity` EntityMappingDtoIn, required
      - `identifier` string, required
      - `name` string, required
      - `properties` object
      - `relations` EntityDynamicMappingRelationDtoIn[]
        - `name` string, required
        - `target_entity_identifiers` string[], required
  - `payload` unknown, required

## Response `200`

Dry-run completed successfully

## Other responses

- `400` — Invalid entity dynamic mapping data provided
- `404` — Entity template not found with the provided identifier
- `422` — Mapping validation, template validation or expression evaluation error

## Changes

- **2026-08-26** `e6f6d45eade3` — 3 breaking, 3 warning, 3 info
  - added the new required request property `mapping/action`
  - the request property `mapping/filter` became required
  - the `mapping/filter` request property's minLength was increased from `0` to `1`
  - removed the optional property `errorDescription` from the response with the `400` status
  - …5 more
- **2026-08-06** `7e634c43bc1b` — 5 info
  - api operation id `dryRunMapping` removed and replaced with `executeDryRun`
  - the request property `mapping/entity/properties` became optional
  - the request property `mapping/entity/relations` became optional
  - the request property `mapping/filter` became optional
  - …1 more
- **2026-08-05** `00ae15bb3a81` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/decathlon/apis/idp-core-api/changes/api/v1/entity_dynamic_mappings/dry-run/post.md)

---

[API](https://skmtc.dev/decathlon/apis/idp-core-api.md) · [All operations](https://skmtc.dev/decathlon/apis/idp-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/decathlon/idp-core-api/revisions/5081d87614ba/schema)