---
title: "Refresh Report Widgets"
method: POST
path: "/v1/reports/{id}/refresh"
tags: ["Reports"]
---

# Refresh Report Widgets

`POST /v1/reports/{id}/refresh`

## Request

- Base URL: `https://api.oviond.com`
- URL: `https://api.oviond.com/v1/reports/{id}/refresh`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Re-fetch DATA widgets on the report with their current config and the report date range. Optional `datasource_id` body scopes the refresh to widgets fed by that one source (direct + dependent goals / calc-metrics). Fire-and-forget — results broadcast via Realtime.

## Path parameters

- `id` string, required

## Request body

- object
  - `datasource_id` 'advanced-web-ranking' | 'ac' | 'adroll' | 'ahrefs' | 'basecamp' | 'brightlocal' | 'call-rail' | 'drip' | 'keywords' | 'sendin-blue' | 'sendgrid' | 'moosend' | 'mailer-lite' | 'pingdom' | 'uptime-robot' | 'piwik-pro' | 'wordpress' | 'pabbly-connect' | 'ment' | 'twilio' | 'switchy' | 'vimeo' | 'pinterest' | 'pinterest-ads' | 'gtres' | 'paypal' | 'gps' | 'gs' | 'CUSTOM_IMPORT' | 'CUSTOM_DATA' | 'CALCULATION' | 'GOALS' | 'str' | 'wistia' | 'ca-mon' | 'convertkit' | 'woocommerce' | 'xero' | 'matomo' | 'go-high-level' | 'wcs' | 'bing-webmaster-tools' | 'pipedrive' | 'salesforce' | 'tiktok' | 'tiktok-ads' | 'twr' | 'twr-ads' | 'spf' | 'ytbe' | 'google-local-services-ads' | 'klaviyo' | 'gsh' | 'ga4' | 'lkdin-ads' | 'lkdin-pg' | 'mlchmp' | 'inst-ads' | 'inst' | 'fb-ads' | 'fb-pg' | 'gmb' | 'serpstat' | 'hubspot' | 'gadw' | 'sem-rush' | 'se-ranking' | 'microsoft-ads' | 'plausible' | 'snapchat-ads' | 'microsoft-clarity' | 'serp-watch' | 'vbout' | 'moz' | 'chatgpt-ads' | 'omnisend' | 'airtable' | 'nozzle' | 'surnex' | 'jira' | 'clickup' | 'make' | 'freshdesk' | 'chart-mogul' | 'amplitude' | 'harvest' | 'zoho-crm' | 'clockify' | 'adtraction' | 'shopify' | 'copper' | 'help-scout-docs' | 'close-crm' | 'simplesat' | 'help-scout-mailbox'

## Response `202`

Refresh queued

- object
  - `success` true, required
  - `data` object, required
    - `accepted` true, required
    - `pipeline_sync` 'none' | 'started', required

## Other responses

- `404`: Report not found

## Changes

- **2026-10-20** `4cb0a07daf41`: 1 breaking, 1 info
  - removed the enum value `amazon-advertising` of the request property `datasource_id`
  - added the required property `data/pipeline_sync` to the response with the `202` status

[Operation history](https://skmtc.dev/oviond/apis/oviond-backend-api/changes/v1/reports/:id/refresh/post.md)

---

[API](https://skmtc.dev/oviond/apis/oviond-backend-api.md) · [All operations](https://skmtc.dev/oviond/apis/oviond-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/oviond/apis/oviond-backend-api/revisions/4cb0a07daf41?raw)