# Update Data Transformation Definition

Update Data Transformation Definition by ID.

Endpoint: PUT /datatransformationdefinitions/{id}
Version: 2
Security: apiKey

## Path parameters:

  - `id` (string, required)
    ID of the data mapper definition.
    Example: "5f4b3b3b-4b3b-4b3b-4b3b-4b3b4b3b4b3b"

## Request fields (application/json):

  - `name` (string)
    Name of the Data Transformation Definition.
    Example: "Test definition 1"

  - `mappings` (array)
    Mappings defining transformation

  - `mappings.sourceAttributes` (array)
    List of source attributes.
    Example: ["identifications[*].indentificationType.code"]

  - `mappings.sourceSelections` (array)
    List of source selections.

  - `mappings.sourceSelections.selectionType` (string, required)
    The type of selection to be used for the source values.
    Enum: "CONCATENATION", "XOR"

  - `mappings.sourceSelections.value` (string)
    String which is used as a delimiter when joining multiple source values in CONCATENATION selection type.
    Example: "AE1"

  - `mappings.targetAttributes` (array)
    List of target attributes.
    Example: ["businessPartner.externalId"]

  - `mappings.targetTransformations` (array)
    List of target transformations.

  - `mappings.targetTransformations.constantValue` (string)
    The constant value to map to the target attribute.
    Example: "AE1"

  - `mappings.targetTransformations.transformationName` (string)
    The name of the custom transformation.
    Example: "Custom_Transformation_Name"

  - `mappings.targetTransformations.defaultValue` (string)
    The default value to map to if the source attribute is empty.
    Example: "N/A"

  - `mappings.targetTransformations.transformationType` (string, required)
    The type of transformation to be used for the target attribute.
    Enum: "CAPITALIZE", "CONSTANT_MAPPING", "CUSTOM_TRANSFORMATION", "WORD_LENGTH_SPLIT", "TO_UPPERCASE", "MULTIPLE_SOURCE_AND_TARGET_ATTRIBUTE_SUPPORT", "DEFAULT_IF_EMPTY"

  - `valueMappings` (array)
    Mappings defining transformation

  - `valueMappings.sourceValue` (string)
    The source value for a value mapping.
    Example: "AE1"

  - `valueMappings.targetValue` (string)
    The target value for a value mapping.
    Example: "AE1"

  - `valueMappings.targetAttribute` (string)
    The target attribute (business partner or address for a value mapping).
    Example: "businessPartner.externalId"

  - `values` (array)
    Mappings defining transformation

  - `values.sourceValue` (string)
    The source value for a value mapping
    Example: "AE1"

  - `values.sourceAttribute` (string)
    The source value for a value mapping
    Example: "identifications[*].indentificationType.code"

## Response 200 fields (application/json):

  - `name` (string)
    Name of the Data Transformation Definition.
    Example: "Test definition 1"

  - `mappings` (array)
    Mappings defining transformation

  - `mappings.sourceAttributes` (array)
    List of source attributes.
    Example: ["identifications[*].indentificationType.code"]

  - `mappings.sourceSelections` (array)
    List of source selections.

  - `mappings.sourceSelections.selectionType` (string, required)
    The type of selection to be used for the source values.
    Enum: "CONCATENATION", "XOR"

  - `mappings.sourceSelections.value` (string)
    String which is used as a delimiter when joining multiple source values in CONCATENATION selection type.
    Example: "AE1"

  - `mappings.targetAttributes` (array)
    List of target attributes.
    Example: ["businessPartner.externalId"]

  - `mappings.targetTransformations` (array)
    List of target transformations.

  - `mappings.targetTransformations.constantValue` (string)
    The constant value to map to the target attribute.
    Example: "AE1"

  - `mappings.targetTransformations.transformationName` (string)
    The name of the custom transformation.
    Example: "Custom_Transformation_Name"

  - `mappings.targetTransformations.defaultValue` (string)
    The default value to map to if the source attribute is empty.
    Example: "N/A"

  - `mappings.targetTransformations.transformationType` (string, required)
    The type of transformation to be used for the target attribute.
    Enum: "CAPITALIZE", "CONSTANT_MAPPING", "CUSTOM_TRANSFORMATION", "WORD_LENGTH_SPLIT", "TO_UPPERCASE", "MULTIPLE_SOURCE_AND_TARGET_ATTRIBUTE_SUPPORT", "DEFAULT_IF_EMPTY"

  - `valueMappings` (array)
    Mappings defining transformation

  - `valueMappings.sourceValue` (string)
    The source value for a value mapping.
    Example: "AE1"

  - `valueMappings.targetValue` (string)
    The target value for a value mapping.
    Example: "AE1"

  - `valueMappings.targetAttribute` (string)
    The target attribute (business partner or address for a value mapping).
    Example: "businessPartner.externalId"

  - `values` (array)
    Mappings defining transformation

  - `values.sourceValue` (string)
    The source value for a value mapping
    Example: "AE1"

  - `values.sourceAttribute` (string)
    The source value for a value mapping
    Example: "identifications[*].indentificationType.code"

  - `id` (string)
    Unique identifier for a data transformation definition.
    Example: "SAP.ODM"

  - `createdBy` (string)
    Creator of a resource.
    Example: "76248934691294444"

  - `createdAt` (string)
    Date of creation (ISO 8601-compliant).
    Example: "2025-08-29T09:46:42Z"

  - `modifiedBy` (string)
    User or Client UUID which modified the resource.
    Example: "76248934691294444"

  - `modifiedAt` (string)
    Date of modification (ISO 8601-compliant).
    Example: "2025-08-29T09:46:42Z"

  - `workspaceId` (string)
    Uniquely identifying ID of the workspace.
    Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4"