AdnovaDocs
Analytics

Refresh insights

Force-refreshes the report for one (platform, adAccountId, date window) — the window is the datePreset or a custom startDate+endDate range. Returns 202 immediately — the fresh fetch runs asynchronously. After calling this, poll Fetch ad insights and watch status: PENDING → COMPLETED (or FAILED with a message explaining what broke). Only the main report window is refreshed. Period-over-period windows (popRangeType) use their own cache and are refreshed when they expire. At most one successful refresh per (platform, adAccountId, date window) every 15 minutes is allowed. Extra calls return 429 with a Retry-After header. If the refresh fails before any work is done (e.g. the platform rejects it), you can retry once you fix the underlying issue.

POST
/refresh

Authentication

authentication
api-key<token>

Create an API key from the Adnova dashboard (Account integrations). Pass the key value in the api-key request header on every call.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.adnova.ai/analytics/v1/refresh" \  -H "Content-Type: application/json" \  -d '{    "platform": "facebook",    "adAccountId": "01JAN78QQ6BX9ZPKA6A8JWA6G1",    "workspaceId": "01JF0X2QDQ648YE4J1M56EFBR4",    "datePreset": "last_7d"  }'
{
  "refreshStatus": "REFRESH_QUEUED",
  "nextRefreshAllowedInSeconds": 0
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "message": "string",
  "retryAfterSeconds": 0
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}