HomeGuidesAPI ReferenceChangelog
API Reference

Compares a new catalog file with an existing catalog to identify differences and optionally updates the database. Supports generating detailed reports in different structures and applying updates directly.

This method supports various operational modes, including flat and hierarchical structures for reports.
It allows the results to be returned in JSON or CSV format (the latter only for flat reports).
The 'applyUpdates' parameter controls whether updates are applied directly to the database. When the
'dataModelsReport' mode is selected, it primarily focuses on preparing data models for updates without
presenting them in a structured report format.

Log in to see full request history
Path Params
int32
required

The ID of the existing catalog for comparison.

Query Params
string
Defaults to json

The format of the comparison report. Defaults to JSON; CSV is available for flat reports only.

string
Defaults to flatReport

The mode of operation for comparison. Options are 'flatReport', 'hierarchicalReport', or 'dataModelsReport'. Default is 'flatReport'.

boolean
Defaults to false

Controls whether updates should be applied directly to the database. Default is false.

Body Params
file

The new catalog file for comparison.

Responses
200

Returns a detailed report of the differences or confirms that updates have been applied, depending on the operation mode.

400

Indicates failure due to invalid parameters, unsupported format requests, or file processing issues.

401

Unauthorized access attempt, detailing required roles and permissions.

Language
Credentials
URL
Click Try It! to start a request and see the response here!