steps to update a dataflow using API

[itsMeTechy]

can someone give me the series of steps we need to do to update dataflow mapping. for ex: if the existing mapping for an attribute if its mapped as direct attributes from source, and now need to add a dataprep while mapping to target attribute. how can i do this using API. 

[Devyendar · Accepted solution]

@itsMeTechy 

Here are the series of steps to update dataflow mapping:-

1. Find your dataflow and its mappingSetId
   • GET /data/foundation/flowservice/flows/{flowId}
     • look under transformations[].params.mappingId for the mappingId
2. Fetch the current mapping set
   • GET /data/foundation/conversion/mappingSets/{mappingSetId}
     • Returns the list of mappings
3. Validate your new Data Prep expression (optional but recommended)
   • POST /data/foundation/conversion/languages/el/validate with { "expression": "toUpperCase($.sourceField)" }. If it returns 200/valid, you’re good.

4. Update the mapping set, replace the target attribute’s direct map with an EL expression.

   • PUT /data/foundation/conversion/mappingSets/{mappingSetId} (send back the full mapping set with your edited mappings[]).

5. (If needed) Patch the dataflow to point to a new mapping set

   • If you created a new mapping set instead of editing the existing one, update the flow:
     PATCH /data/foundation/flowservice/flows/{flowId} with the new transformations[].params.mappingId.

6. Run/verify

   • New mapping applies to future ingestions. Past data won’t be remapped unless you re-ingest - https://experienceleague.adobe.com/en/docs/experience-platform/sources/api-tutorials/update-dataflow...

[Devyendar]

@itsMeTechy hope the answer provided was useful, can you mark the response as "Correct Answer" to help the wider community.