Get Configuration history by Version
Learn how the API retrieves a specific version of Autopilot configuration for a tenant.
The Get Configuration history by version API retrieves a specific historical version of the Autopilot configuration for a tenant. The service returns the configuration that corresponds to the requested version number.
You can use this Autopilot API to review past configurations and compare versions. The service retrieves a selected version from stored configuration history without affecting the active configuration.
HTTP method and endpoint
Use the following HTTP method and endpoint path to retrieve a specific version of the Autopilot configuration:
GET /configuration/{tenantId}/autopilot/history/{version}The following table describes the endpoint path parameters.
| Parameter | Type | Required | Description |
|---|---|---|---|
tenantId | String | Yes | Tenant identifier |
version | Integer | Yes | Version number to retrieve |
Request headers
The following request headers must be included.
| Header | Value | Required |
|---|---|---|
Authorization | Bearer {token} | Yes |
Request Body
This operation does not require a request body.
Response body
The following table describes the fields returned in the response body.
| Field | Type | Description |
|---|---|---|
tenantId | String | Unique identifier of the tenant. |
| defaults | ||
defaults | Object | Default Autopilot configuration settings applied at the tenant level. |
enabled | Boolean | Indicates whether Autopilot is enabled. |
mode | String | Operating mode of Autopilot (for example, ACTIVE or PREVIEW). |
autoMapEnabled | Boolean | Indicates whether automatic mapping is enabled. |
autoMapThreshold | Number | Minimum similarity score required for automatic mapping. |
suggestionEnabled | Boolean | Indicates whether mapping suggestions are enabled. |
suggestionThreshold | Number | Minimum score required to generate a mapping suggestion. |
createLookupEnabled | Boolean | Indicates whether automatic creation of new lookup values is enabled. |
createLookupThreshold | Number | Minimum score required to automatically create a new lookup value. |
suggestLookupEnabled | Boolean | Indicates whether suggestions to create new lookup values are enabled. |
suggestLookupThreshold | Number | Minimum score required to suggest creating a new lookup value. |
misspelledThreshold | Number | Minimum score used to detect potential misspellings. |
requiredFrequency | Number | Minimum number of occurrences required before Autopilot takes action. |
frequencyWindowHours | Number | Time window, in hours, used to evaluate frequency. |
| lookupTypes | ||
lookupTypes | Array | List of lookup type-specific configurations. Empty if no overrides are defined. |
updatedBy | String | Identifier of the user who last updated the configuration. |
updateDate | Number | Timestamp of the last update in epoch milliseconds. |
version | Number | Version number of the configuration. |
anyEnabled | Boolean | Indicates whether Autopilot is enabled for any scope. |
Example response
The following example shows a response body with the tenant-level default matching configuration, lookup type settings, and audit metadata.
{
"tenantId": "my_tenant",
"defaults": {
"enabled": true,
"mode": "ACTIVE",
"autoMapEnabled": true,
"autoMapThreshold": 0.9,
"suggestionEnabled": true,
"suggestionThreshold": 0.8,
"createLookupEnabled": true,
"createLookupThreshold": 0.9,
"suggestLookupEnabled": true,
"suggestLookupThreshold": 0.75,
"misspelledThreshold": 0.7,
"requiredFrequency": 1,
"frequencyWindowHours": 1
},
"lookupTypes": [],
"updatedBy": "my_user",
"updateDate": 1775474092854,
"version": 1,
"anyEnabled": true
}