Refresh Analytics Target

​

Billing

• If the target is still inside its free refresh window, wasFree=true and credits_used=0.
• When the free window is exhausted, refresh consumes credits (credits_used > 0).
• Seat billing (target upkeep) is charged separately from per-refresh billing.

​

Path Parameters

​

Response

curl --request POST \
  --url https://www.genviral.io/api/partner/v1/analytics/targets/e7a7f417-56db-4320-9e9a-fd6fdabda09d/refresh \
  --header 'Authorization: Bearer <token>'

{
  "ok": true,
  "code": 200,
  "message": "Analytics refresh queued",
  "data": {
    "refresh": {
      "id": "fd8f615f-971e-4f9f-85dc-f8e55fb0a413",
      "target_id": "e7a7f417-56db-4320-9e9a-fd6fdabda09d",
      "workspace_id": "4cb5d3fd-8c8f-4ed7-a17c-4ffb52c7e6ac",
      "status": "pending",
      "free_refresh_used": true,
      "credits_used": 0,
      "started_at": "2026-02-14T16:05:11.025Z",
      "completed_at": null,
      "error": null
    },
    "wasFree": true
  }
}

​

Error Responses

• 400 missing_target_id - missing path parameter
• 402 - insufficient credits for paid refresh
• 409 analytics_conflict - another refresh is already running for this target
• 429 rate_limited - too many refresh requests for the same target in a short window
• 404 - target not found in authenticated key scope
• 401/403 - authentication failed or key lacks required scope access
• 500 - unexpected refresh execution error