Widgets

Update Widget

Changed on

Update a single widget (partial update).

put/v1/widgets/{id}

Request

  • Base URL: https://api.oviond.com
  • URL: https://api.oviond.com/v1/widgets/{id}
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

idstring required

Request body

source_type'project' | 'template' nullable
source_idstring nullable
page_idstring nullable
client_idstring nullable
type'DATA' | 'TEXT' | 'IMAGE' | 'HTML' | 'VIDEO' | 'EMBED' | 'TITLE' | 'BUTTON' | 'GOAL' nullable
chart'table' | 'score' | 'area' | 'line' | 'bar' | 'column' | 'pie' | 'donut' | 'funnel' | 'map' | 'areaspline' | 'spline' | 'stacked_area' | 'percentage_area' | 'stacked_column' | 'stacked_bar' | '100_stacked_column' | '3d_bar' | '3d_column' | '3d_pie' | '3d_donut' | 'funnel3d' | 'custom' nullable
chart_type'table' | 'score' | 'area' | 'line' | 'bar' | 'column' | 'pie' | 'donut' | 'funnel' | 'map' | 'areaspline' | 'spline' | 'stacked_area' | 'percentage_area' | 'stacked_column' | 'stacked_bar' | '100_stacked_column' | '3d_bar' | '3d_column' | '3d_pie' | '3d_donut' | 'funnel3d' | 'custom' nullable
chart_group'line' | 'area' | 'bar' | 'pie' | 'funnel' | 'table' | 'score' | 'map' | 'column' | 'donut' | 'column_bar_charts' | 'line_area_charts' | 'pie_donut_charts' | 'scorecard' nullable
state'loading' | 'LOADING' | 'active' | 'ACTIVE' | 'error' | 'ERROR' | 'NO_DATA' | 'demo' | 'DEMO' nullable
titlestring nullable
textstring nullable
namestring nullable
auto_generated_namestring nullable
heading'h1' | 'h2' | 'h3' | 'h4' | 'h5' nullable
align'left' | 'center' | 'right' | 'justify' nullable
linkstring nullable
link_urlstring nullable
image_fit'object-contain' | 'object-cover' | 'object-fill' | 'object-none' nullable
embed_type'URL' | 'IFRAME' | 'HTML' nullable
embed_urlstring nullable
embed_iframestring nullable
embed_htmlstring nullable
sizestring nullable
descriptionstring nullable
contentstring nullable
srcstring nullable
urlstring nullable
iconstring nullable
targetstring nullable
image_link_urlstring nullable
xnumber nullable
ynumber nullable
widthnumber nullable
heightnumber nullable
is_secondaryboolean nullable
icon_position'top' | 'right' | 'bottom' | 'left' | 'none' nullable
options_3dboolean nullable
kpiboolean nullable
blendedboolean nullable
row_limit'5' | '10' | '25' | '50' | '100' | '500' | 'all' nullable
comparison_display'previous' | 'change' | 'both' nullable
sort_orderstring nullable
sort_bystring nullable
column_widthsobject nullable
b_heightstring nullable
legend_position'top' | 'right' | 'bottom' | 'left' | 'none' nullable
invert_y_axisboolean nullable
show_headerboolean nullable
show_nameboolean nullable
show_iconboolean nullable
show_dateboolean nullable
show_grid_linesboolean nullable
show_legendsboolean nullable
show_x_axisboolean nullable
show_y_axisboolean nullable
show_trendlineboolean nullable
show_totalsboolean nullable
show_searchboolean nullable
show_table_filtersboolean nullable
show_logarithmicboolean nullable
show_multiple_axesboolean nullable
show_custom_date_rangeboolean nullable
show_descriptionboolean nullable
show_containerboolean nullable
show_label_listboolean nullable
show_chartboolean nullable
expand_rowsboolean nullable
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' | 'demo' nullable
datasource_type'DATASOURCE' | 'CALCULATION' | 'CUSTOM_DATA' | 'CUSTOM_IMPORT' | 'GOALS' nullable
data_viewstring nullable
advancedobject nullable
current_dataobject[] nullable
current_summaryobject nullable
previous_dataobject[] nullable
previous_summaryobject nullable
series_fetched_atstring nullable
error_statusunknown
created_atunknown

Example request

{
  "filters": [
    {
      "field": "sessionMedium",
      "operator": "contains"
    }
  ],
  "currency": {
    "code": "USD",
    "symbol": "$",
    "iso": "US"
  },
  "date_range": {
    "text": "Last 30 Days",
    "compare": "None",
    "current_start": "2026-03-01",
    "current_end": "2026-03-31",
    "previous_start": "2026-02-01",
    "previous_end": "2026-02-28",
    "custom_days": 60,
    "custom_months": 3
  }
}

Response

Updated

successtrue required

Changes