Schedule an automatic Insights-Refresh
This endpoint is used to schedule a specific account or all accounts of a consumer to be automatically refreshed.
If a schedule call includes an account that was scheduled before the schedule parameters (like refresh_days
, data_retention_minutes
or refresh_interval_minutes
) for it will be updated to the new ones.
Starting the Consent Insights Refresh
POST /insights/v1/autorefresh/schedule HTTP/1.1
Content-Type: application/json; charset=utf-8
Authorization: Bearer <Token>
Host: <Host>
{
"insights_consumer_id" : string,
"insights_account_ids" : ?Array<String>,
"intended_reports" : ?Array<IntendedReport>,
"refresh_days": ?int,
"data_retention_minutes" : ?int,
"refresh_interval_minutes" : int
}
The insights_consumer_id
of the consumer which accounts should be scheduled for an automatic refresh. If the insights_account_ids
property is not set all accounts of this consumer are scheduled to auto refresh.
The insights_account_ids
specify which accounts of the consumer should be automatically refreshed.
The intended_reports
specifies which reports should later be generated with the extracted data. Using this property reduces the amount of data that is extracted from the consumers account. As default data for all available reports are extracted.
Defines how many days of data (eg. for transactions) should be received during the auto refresh.
The number of minutes that the data are stored. Default is 10 minutes.
The minutes between each automatic refresh.
Response
The response body is empty if the scheduling was successful. For unsuccessful requests the error format can be found here.
{}
Example Request
In the follwing example an auto refreshs is scheduled for all accounts of the consumer that is identified by the given insights_consumer_id
and the refresh is done every 8 hours. The data are kept for 24 hours.
{
"insights_consumer_id": "d5e12345-6f7b-4b03-b018-6c158f0b281d",
"refresh_interval_minutes": 480,
"data_retention_minutes": 1440
}