Get Configuration history

Learn how the API retrieves Autopilot configuration history for a tenant with pagination support.

The Get Configuration history API retrieves the history of Autopilot configuration changes for a tenant. The service returns a list of configuration versions sorted by updateDate in descending order.

You can use pagination parameters to control the number of results and navigate through large history sets. Each record represents a previously saved configuration version.

Use this API to track configuration changes over time and review earlier versions when needed.

HTTP method and endpoint

Use the following HTTP method and endpoint path to submit the request for retrieving the Autopilot configuration history for a tenant.

GET /configuration/{tenantId}/autopilot/history?offset={offset}&limit={limit}

The following table describes the endpoint path parameters.


Parameter	Type	Required	Description
`tenantId`	String	Yes	Tenant identifier

Query parameters

The following table describes the query parameters and their values.


Parameter	Type	Required	Description	Accepted values / Default
`offset`	Integer	No	Starting offset for pagination.	Default: `0`
`limit`	Integer	No	Maximum number of results.	Default `20`, Max: `100`

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. This operation returns a list of Autopilot configuration objects.


Field	Type	Description
`tenantId`	string	Tenant identifier.
`updatedBy`	string	User who last updated the configuration.
`updateDate`	integer	Timestamp of the last update in epoch milliseconds.
`version`	integer	Version number of the configuration.
`defaults`	object	Default Autopilot settings for the tenant.
defaults
`enabled`	boolean	Enables or disables Autopilot.
`mode`	string	Operating mode for Autopilot.
`autoMapEnabled`	boolean	Enables automatic mapping.
`autoMapThreshold`	number	Confidence threshold for automatic mapping.
`suggestionEnabled`	boolean	Enables suggestions for mapping.
`suggestionThreshold`	number	Confidence threshold for suggestions.
`createLookupEnabled`	boolean	Enables automatic lookup creation.
`createLookupThreshold`	number	Confidence threshold for lookup creation.
`suggestLookupEnabled`	boolean	Enables lookup suggestions/lookup creation suggestions.
`suggestLookupThreshold`	number	Confidence threshold for lookup suggestions.
`misspelledThreshold`	number	Threshold used for misspelling detection.
`requiredFrequency`	integer	Minimum occurrence frequency required before applying certain actions.
`frequencyWindowHours`	integer	Time window, in hours, used when evaluating frequency.

Example Response

The following example shows a successful response.

[
  {
    "tenantId": "my_tenant",
    "updatedBy": "admin@company.com",
    "updateDate": 1704153600000,
    "version": 3,
    "defaults": {
      "enabled": true,
      "mode": "ACTIVE",
      "autoMapEnabled": true,
      "autoMapThreshold": 0.90,
      "suggestionEnabled": true,
      "suggestionThreshold": 0.75,
      "createLookupEnabled": false,
      "createLookupThreshold": 0.90,
      "suggestLookupEnabled": false,
      "suggestLookupThreshold": 0.75,
      "misspelledThreshold": 0.70,
      "requiredFrequency": 10,
      "frequencyWindowHours": 1
    }
  },
  {
    "tenantId": "my_tenant",
    "updatedBy": "admin@company.com",
    "updateDate": 1704067200000,
    "version": 2,
    "defaults": {
      "enabled": true,
      "mode": "PREVIEW",
      "autoMapEnabled": true,
      "autoMapThreshold": 0.95,
      "suggestionEnabled": false,
      "suggestionThreshold": 0.75,
      "createLookupEnabled": false,
      "createLookupThreshold": 0.90,
      "suggestLookupEnabled": false,
      "suggestLookupThreshold": 0.75,
      "misspelledThreshold": 0.70,
      "requiredFrequency": 10,
      "frequencyWindowHours": 1
    }
  }
]

Unify and manage your data