Deprecated Calls Removal
In addition to the reorganization of the API Reference and the deprecation announcement of a limited list of overlapping V4 operations, we are also announcing the end of service date of a number of operations that were already flagged as deprecated in the developers portal.
As these operations have been marked as deprecated a long time ago already, they see very little usage. Their removal will hardly impact your integrations.
The detailed explanation for deprecated operations use the old URL schemes (before the API Reference reorganization), as those are certainly the paths used in your code.
The new URL scheme of these deprecated V4 operations can be seen by clicking the links to the developers portal.
The equivalent replacements are always documented with the new URL schemes, as adaptations should be made with the up-to-date path.
Retrieve the results and error files of a mono file ETL
The operation to 'Get a single ETL execution's errors files' is a V5 call that allowed to retrieve the error file of an ETL excution.
> GET /v5/entities/{entity}/etl-executions/{executionId}/errors
It can be replaced by the V5 operation 'Get a single ETL execution's output files' that allows to retrieve both the error and the result file of this execution at once.
> GET /mass-imports/v5/entities/{entity}/etl-executions/{executionId}/output-files
The generation of both files depend on the result of the ETL and whether their generation is activated in the ETL definition.
The operation to 'Get a single mono file ETL execution's results' is a V5 call that was used before the development of multi file ETLs.
> GET /v5/entities/{entity}/etl-executions/{executionId}/results
It can be replaced by the V5 operation 'Get a single ETL execution's results', which works regardless of the number of files processed by the ETL.
> GET /mass-imports/v5/entities/{entity}/etl-executions/{executionId}/integration-results
Timing
The deprecated operations will continue working until May 2025.