Skip to main content
PUT
Update Widget

Authorizations

Authorization
string
header
required

Oviond API key (prefix oviond_) sent as a Bearer token — the credential for REST/programmatic and headless integrations. Manage keys in Settings → API Keys. API keys do NOT authenticate the MCP endpoint (/mcp), which uses OAuth 2.1 + PKCE.

Path Parameters

id
string
required

Body

application/json
source_type
enum<string> | null
Available options:
project,
template
source_id
string | null
page_id
string | null
client_id
string | null
type
enum<string> | null
Available options:
DATA,
TEXT,
IMAGE,
HTML,
VIDEO,
EMBED,
TITLE,
BUTTON,
GOAL
chart
enum<string> | null
Available options:
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
chart_type
enum<string> | null
Available options:
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
chart_group
enum<string> | null
Available options:
line,
area,
bar,
pie,
funnel,
table,
score,
map,
column,
donut,
column_bar_charts,
line_area_charts,
pie_donut_charts,
scorecard
state
enum<string> | null
Available options:
loading,
LOADING,
active,
ACTIVE,
error,
ERROR,
NO_DATA,
demo,
DEMO
title
string | null
text
string | null
name
string | null
auto_generated_name
string | null
heading
enum<string> | null
Available options:
h1,
h2,
h3,
h4,
h5
align
enum<string> | null
Available options:
left,
center,
right,
justify
image_fit
enum<string> | null
Available options:
object-contain,
object-cover,
object-fill,
object-none
embed_type
enum<string> | null
Available options:
URL,
IFRAME,
HTML
embed_url
string | null
embed_iframe
string | null
embed_html
string | null
size
string | null
description
string | null
content
string | null
src
string | null
url
string | null
icon
string | null
target
string | null
x
number | null
y
number | null
width
number | null
height
number | null
is_secondary
boolean | null
icon_position
enum<string> | null
Available options:
top,
right,
bottom,
left,
none
options_3d
boolean | null
kpi
boolean | null
blended
boolean | null
row_limit
enum<string> | null
Available options:
5,
10,
25,
50,
100,
500,
all
comparison_display
enum<string> | null
Available options:
previous,
change,
both
sort_order
string | null
sort_by
string | null
column_widths
object | null
b_height
string | null
legend_position
enum<string> | null
Available options:
top,
right,
bottom,
left,
none
invert_y_axis
boolean | null
show_header
boolean | null
show_name
boolean | null
show_icon
boolean | null
show_date
boolean | null
show_grid_lines
boolean | null
show_legends
boolean | null
show_x_axis
boolean | null
show_y_axis
boolean | null
show_trendline
boolean | null
show_totals
boolean | null
show_search
boolean | null
show_table_filters
boolean | null
show_logarithmic
boolean | null
show_multiple_axes
boolean | null
show_custom_date_range
boolean | null
show_description
boolean | null
show_container
boolean | null
show_label_list
boolean | null
show_chart
boolean | null
expand_rows
boolean | null
datasource_id
enum<string> | null
Available options:
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,
amazon-advertising,
microsoft-clarity,
serp-watch,
vbout,
moz,
chatgpt-ads,
demo
datasource_type
enum<string> | null
Available options:
DATASOURCE,
CALCULATION,
CUSTOM_DATA,
CUSTOM_IMPORT,
GOALS
data_view
string | null
metrics
object[] | null
dimensions
object[] | null
filters
object[] | null
advanced
object | null
currency

ISO 4217 currency code (e.g. "USD") or a full { code, symbol, iso } object.

date_range
object
current_data
object[] | null
current_summary
object | null
previous_data
object[] | null
previous_summary
object | null
series_fetched_at
string | null
created_at
any

Response

Updated

success
enum<boolean>
required
Available options:
true