Adds a widget: a chart, metric or table that runs SQL (see sql), or a text widget. Left without a position, it goes at the left below the lowest widget, sized as the reports page sizes a new one. A 409 with Retry-After means another change held the report, so nothing was written: send it again.
An API key, sent as Authorization: Bearer stfy_live_…. See Authentication for how to get one and which scopes it needs.
Path Parameters
report_id
string
required
The report's id, from GET /v1/reports
Body
application/json
title
string
required
Required string length: 1 - 255
type
enum<string>
required
Available options:
metric,
bar_chart,
line_chart,
area_chart,
pie_chart,
scatter_chart,
table,
text
chart
ReportChartInput · object | null
For a chart, metric or table: its display settings
Show child attributes
markdown
boolean | null
For a text widget: show text as Markdown (default true)
position
ReportWidgetPositionInput · object | null
Where it sits on the report's grid (12 columns wide). Left out or null, it goes at the left below the lowest widget, sized as the reports page sizes a new one (metric 3x2, bar_chart 6x4, line_chart 6x4, area_chart 6x4, pie_chart 4x4, scatter_chart 6x4, table 12x4, text 4x2)
Show child attributes
sql
string | null
For a chart, metric or table: one SELECT over the report views, as POST /v1/reports/query takes it (WITH queries are fine), except that a UNION, INTERSECT or EXCEPT can't be the whole statement (one can be in a subquery). On the reports page, a report's filter on a view's column is added to the outer SELECT's WHERE, so on a LEFT JOINed view it also drops the rows the join didn't match. It reaches the view through the outer FROM: the view itself, or a WITH query or subquery whose SELECT returns the column under the same name or with a bare . The widget skips a filter it can't reach that way, such as through a renamed or aggregated column, a v., or a UNION, and one on a view the outer FROM reads twice. There, a viewer who sees only their own accounts reads every report view in it limited to those accounts, wherever it is named (people_internal_view, your workspace's own people, belongs to no account and isn't limited). What is saved is the checked statement, as POST /v1/reports/query returns it in sql: without comments or your workspace's schema name, with some spellings normalized
Required string length: 1 - 20000
text
string | null
For a text widget: its content
Maximum string length: 20000
Response
201 - application/json
Successful Response
built_with
enum<string>
required
sql (it runs SQL: sql holds it), builder (made with the visual query builder; the API doesn't return its query), or text (a text widget: text holds it)
Available options:
sql,
builder,
text
chart
ReportChart · object
required
A widget's display settings, as the reports page stores them.
Show child attributes
id
string
required
position
ReportWidgetPosition · object | null
required
Where it sits on the report's grid; null if what's stored can't be read
Show child attributes
title
string
required
type
string
required
metric, bar_chart, line_chart, area_chart, pie_chart, scatter_chart, table or text
markdown
boolean | null
A text widget's Markdown option: true shows text as Markdown, false as plain text
sql
string | null
The widget's SQL as saved in the app: it may have comments or your workspace's schema name. On the reports page it runs with the report's filters and the viewer's scope added, under the app's own checks, so POST /v1/reports/query may refuse it or return different rows
text
string | null
A text widget's content. The app shows it as Markdown when the widget's Markdown option is on (new text widgets have it on), otherwise as plain text
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Statisfy","description":"Statisfy is an agentic platform for customer intelligence, supporting both pre-sales and post-sales workflows with unified customer context across the entire customer lifecycle.","colors":{"primary":"#6366F1","light":"#818CF8","dark":"#4F46E5"},"logo":{"light":"https://mintcdn.com/statisfy/-mEFnxVd9s5kL3ir/resources/logo-light.svg?fit=max\u0026auto=format\u0026n=-mEFnxVd9s5kL3ir\u0026q=85\u0026s=c42ea5d3e828945c05d618cdb0f658b9","dark":"https://mintcdn.com/statisfy/-mEFnxVd9s5kL3ir/resources/logo-dark.svg?fit=max\u0026auto=format\u0026n=-mEFnxVd9s5kL3ir\u0026q=85\u0026s=252d43adf6de24dd1079dcd2cd276f72","href":"https://statisfy.com"},"favicon":"https://mintcdn.com/statisfy/-mEFnxVd9s5kL3ir/favicon.svg?fit=max\u0026auto=format\u0026n=-mEFnxVd9s5kL3ir\u0026q=85\u0026s=d8936b2ddf2ff2af5ad66c7673c2a97e","navbar":{"links":[{"href":"mailto:support@statisfy.com","label":"Support"}]},"footer":{"socials":{"linkedin":"https://linkedin.com/company/statisfy"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"statisfy","hasAudioNarration":false,"actualSubdomain":"statisfy","customDomains":["help.statisfy.com"],"gitSource":{"type":"github","owner":"statisfy-us","repo":"repo","deployBranch":"main","contentDirectory":"help-docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afc440724a397d42d541e36","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"Statisfy API","count":314},{"language":"default","tag":"Endpoints","count":310},{"language":"default","tag":"Documentation","count":134},{"language":"default","tag":"Integrations","count":60},{"language":"default","tag":"integrations","count":52},{"language":"default","tag":"automations","count":29},{"language":"default","tag":"Admin","count":25},{"language":"default","tag":"Portals","count":20},{"language":"default","tag":"Settings","count":18},{"language":"default","tag":"API Reference","count":14}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@statisfy.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"rest-api/reference/reports/add-a-widget-to-a-report","slug":"/rest-api/reference/reports/add-a-widget-to-a-report","pageMetadata":{"title":"Add a widget to a report","description":"Adds a widget: a chart, metric or table that runs SQL (see `sql`), or a text widget. Left without a position, it goes at the left below the lowest widget, sized as the reports page sizes a new one. A 409 with Retry-After means another change held the report, so nothing was written: send it again.","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/reports/{report_id}/widgets","href":"/rest-api/reference/reports/add-a-widget-to-a-report","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Adds a widget: a chart, metric or table that runs SQL (see \", _jsx(_components.code, {\n children: \"sql\"\n }), \"), or a text widget. Left without a position, it goes at the left below the lowest widget, sized as the reports page sizes a new one. A 409 with Retry-After means another change held the report, so nothing was written: send it again.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Add a widget to a report","description":"Adds a widget: a chart, metric or table that runs SQL (see `sql`), or a text widget. Left without a position, it goes at the left below the lowest widget, sized as the reports page sizes a new one. A 409 with Retry-After means another change held the report, so nothing was written: send it again.","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/reports/{report_id}/widgets","href":"/rest-api/reference/reports/add-a-widget-to-a-report","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Adds a widget: a chart, metric or table that runs SQL (see `sql`), or a text widget. Left without a position, it goes at the left below the lowest widget, sized as the reports page sizes a new one. A 409 with Retry-After means another change held the report, so nothing was written: send it again.","operationId":"reports_create_widget","parameters":["6f881acd-3cb8-486c-b5b4-97d2e14cbd1b"],"requestBody":"df9c233e-39dc-4f53-9051-9708431febe2","responses":{"201":"7a9d1d3d-d9e8-492a-a5e8-b98fea498e03"},"security":["42f8b5be-5ab7-4163-8c6b-da6c8db547ae"],"summary":"Add a widget to a report","tags":["reports"],"x-capability-id":"reports.create_widget","x-required-scope":"reports:create","method":"post","type":"path","servers":["96d28bbe-8b23-4fbd-b189-be6b2ecb3cdc"],"path":"/v1/reports/{report_id}/widgets","baseUrlOptions":["https://api.statisfy.com"],"title":"Add a widget to a report","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"6f881acd-3cb8-486c-b5b4-97d2e14cbd1b":{"description":"The report's id, from GET /v1/reports","in":"path","name":"report_id","required":true,"schema":{"type":"string","isRequired":true,"description":"The report's id, from GET /v1/reports","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"title":{"maxLength":255,"minLength":1,"title":"Title","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"type":{"enum":["metric","bar_chart","line_chart","area_chart","pie_chart","scatter_chart","table","text"],"title":"Type","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"chart":{"oneOf":[{"type":"object","title":"ReportChartInput","description":"For a chart, metric or table: its display settings","properties":{"colors":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"chart.oneOf.0.colors.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Colors","description":"The palette, as CSS colors","uniqueKey":"chart.oneOf.0.colors.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Colors","description":"The palette, as CSS colors","uniqueKey":"chart.oneOf.0.colors.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.oneOf.0.colors","typeLabel":"string[] | null"},"compact_notation":{"oneOf":[{"type":"string","title":"Compact Notation","enum":["K","M","B","T"],"uniqueKey":"chart.oneOf.0.compact_notation.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Compact Notation","uniqueKey":"chart.oneOf.0.compact_notation.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.oneOf.0.compact_notation","typeLabel":"enum\u003cstring> | null"},"currency_symbol":{"oneOf":[{"type":"string","title":"Currency Symbol","uniqueKey":"chart.oneOf.0.currency_symbol.oneOf.0","typeLabel":"string"},{"type":"null","title":"Currency Symbol","uniqueKey":"chart.oneOf.0.currency_symbol.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.oneOf.0.currency_symbol","typeLabel":"string | null"},"decimal_digits":{"oneOf":[{"type":"integer","title":"Decimal Digits","maximum":20,"minimum":0,"uniqueKey":"chart.oneOf.0.decimal_digits.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Decimal Digits","uniqueKey":"chart.oneOf.0.decimal_digits.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.oneOf.0.decimal_digits","typeLabel":"integer | null"},"max_series":{"oneOf":[{"type":"integer","title":"Max Series","description":"Show the top N series by total","minimum":1,"uniqueKey":"chart.oneOf.0.max_series.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Max Series","description":"Show the top N series by total","uniqueKey":"chart.oneOf.0.max_series.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.oneOf.0.max_series","typeLabel":"integer | null"},"orientation":{"oneOf":[{"type":"string","title":"Orientation","enum":["vertical","horizontal"],"uniqueKey":"chart.oneOf.0.orientation.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Orientation","uniqueKey":"chart.oneOf.0.orientation.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.oneOf.0.orientation","typeLabel":"enum\u003cstring> | null"},"page_size":{"oneOf":[{"type":"integer","title":"Page Size","description":"A table's rows per page","minimum":1,"uniqueKey":"chart.oneOf.0.page_size.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Page Size","description":"A table's rows per page","uniqueKey":"chart.oneOf.0.page_size.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.oneOf.0.page_size","typeLabel":"integer | null"},"pivot_column":{"oneOf":[{"type":"string","title":"Pivot Column","description":"A table's column whose values become columns","uniqueKey":"chart.oneOf.0.pivot_column.oneOf.0","typeLabel":"string"},{"type":"null","title":"Pivot Column","description":"A table's column whose values become columns","uniqueKey":"chart.oneOf.0.pivot_column.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.oneOf.0.pivot_column","typeLabel":"string | null"},"series_column":{"oneOf":[{"type":"string","title":"Series Column","description":"A column whose values split the data into series","uniqueKey":"chart.oneOf.0.series_column.oneOf.0","typeLabel":"string"},{"type":"null","title":"Series Column","description":"A column whose values split the data into series","uniqueKey":"chart.oneOf.0.series_column.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.oneOf.0.series_column","typeLabel":"string | null"},"show_data_labels":{"oneOf":[{"type":"boolean","title":"Show Data Labels","uniqueKey":"chart.oneOf.0.show_data_labels.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Show Data Labels","uniqueKey":"chart.oneOf.0.show_data_labels.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.oneOf.0.show_data_labels","typeLabel":"boolean | null"},"show_legend":{"oneOf":[{"type":"boolean","title":"Show Legend","uniqueKey":"chart.oneOf.0.show_legend.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Show Legend","uniqueKey":"chart.oneOf.0.show_legend.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.oneOf.0.show_legend","typeLabel":"boolean | null"},"stacked":{"oneOf":[{"type":"boolean","title":"Stacked","uniqueKey":"chart.oneOf.0.stacked.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Stacked","uniqueKey":"chart.oneOf.0.stacked.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.oneOf.0.stacked","typeLabel":"boolean | null"},"value_column":{"oneOf":[{"type":"string","title":"Value Column","description":"The column a pivot spreads","uniqueKey":"chart.oneOf.0.value_column.oneOf.0","typeLabel":"string"},{"type":"null","title":"Value Column","description":"The column a pivot spreads","uniqueKey":"chart.oneOf.0.value_column.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.oneOf.0.value_column","typeLabel":"string | null"},"value_format":{"oneOf":[{"type":"string","title":"Value Format","description":"How the widget's values read: a metric's value, a chart's axis","enum":["number","currency","percent","compact"],"uniqueKey":"chart.oneOf.0.value_format.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Value Format","description":"How the widget's values read: a metric's value, a chart's axis","uniqueKey":"chart.oneOf.0.value_format.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.oneOf.0.value_format","typeLabel":"enum\u003cstring> | null"},"x_axis":{"oneOf":[{"type":"string","title":"X Axis","description":"The column on the x axis","uniqueKey":"chart.oneOf.0.x_axis.oneOf.0","typeLabel":"string"},{"type":"null","title":"X Axis","description":"The column on the x axis","uniqueKey":"chart.oneOf.0.x_axis.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.oneOf.0.x_axis","typeLabel":"string | null"},"y_axis":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"chart.oneOf.0.y_axis.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Y Axis","description":"The columns plotted, one series each","uniqueKey":"chart.oneOf.0.y_axis.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Y Axis","description":"The columns plotted, one series each","uniqueKey":"chart.oneOf.0.y_axis.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.oneOf.0.y_axis","typeLabel":"string[] | null"}},"additionalProperties":false,"uniqueKey":"chart.oneOf.0","typeLabel":"ReportChartInput · object"},{"type":"null","description":"For a chart, metric or table: its display settings","uniqueKey":"chart.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart","typeLabel":"ReportChartInput · object | null"},"markdown":{"oneOf":[{"type":"boolean","title":"Markdown","description":"For a text widget: show `text` as Markdown (default true)","uniqueKey":"markdown.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Markdown","description":"For a text widget: show `text` as Markdown (default true)","uniqueKey":"markdown.oneOf.1","typeLabel":"null"}],"uniqueKey":"markdown","typeLabel":"boolean | null"},"position":{"oneOf":[{"type":"object","title":"ReportWidgetPositionInput","description":"Where it sits on the report's grid (12 columns wide). Left out or null, it goes at the left below the lowest widget, sized as the reports page sizes a new one (metric 3x2, bar_chart 6x4, line_chart 6x4, area_chart 6x4, pie_chart 4x4, scatter_chart 6x4, table 12x4, text 4x2)","required":["x","y","w","h"],"properties":{"h":{"description":"Height, in rows","maximum":100,"minimum":1,"title":"H","type":"integer","isRequired":true,"uniqueKey":"position.oneOf.0.h","typeLabel":"integer"},"w":{"description":"Width, in columns; x + w is at most 12","maximum":12,"minimum":1,"title":"W","type":"integer","isRequired":true,"uniqueKey":"position.oneOf.0.w","typeLabel":"integer"},"x":{"description":"Columns from the left of the grid","maximum":11,"minimum":0,"title":"X","type":"integer","isRequired":true,"uniqueKey":"position.oneOf.0.x","typeLabel":"integer"},"y":{"description":"Rows from the top","maximum":10000,"minimum":0,"title":"Y","type":"integer","isRequired":true,"uniqueKey":"position.oneOf.0.y","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"position.oneOf.0","typeLabel":"ReportWidgetPositionInput · object"},{"type":"null","description":"Where it sits on the report's grid (12 columns wide). Left out or null, it goes at the left below the lowest widget, sized as the reports page sizes a new one (metric 3x2, bar_chart 6x4, line_chart 6x4, area_chart 6x4, pie_chart 4x4, scatter_chart 6x4, table 12x4, text 4x2)","uniqueKey":"position.oneOf.1","typeLabel":"null"}],"uniqueKey":"position","typeLabel":"ReportWidgetPositionInput · object | null"},"sql":{"oneOf":[{"type":"string","title":"Sql","description":"For a chart, metric or table: one SELECT over the report views, as POST /v1/reports/query takes it (WITH queries are fine), except that a UNION, INTERSECT or EXCEPT can't be the whole statement (one can be in a subquery). On the reports page, a report's filter on a view's column is added to the outer SELECT's WHERE, so on a LEFT JOINed view it also drops the rows the join didn't match. It reaches the view through the outer FROM: the view itself, or a WITH query or subquery whose SELECT returns the column under the same name or with a bare *. The widget skips a filter it can't reach that way, such as through a renamed or aggregated column, a v.*, or a UNION, and one on a view the outer FROM reads twice. There, a viewer who sees only their own accounts reads every report view in it limited to those accounts, wherever it is named (people_internal_view, your workspace's own people, belongs to no account and isn't limited). What is saved is the checked statement, as POST /v1/reports/query returns it in `sql`: without comments or your workspace's schema name, with some spellings normalized","maxLength":20000,"minLength":1,"uniqueKey":"sql.oneOf.0","typeLabel":"string"},{"type":"null","title":"Sql","description":"For a chart, metric or table: one SELECT over the report views, as POST /v1/reports/query takes it (WITH queries are fine), except that a UNION, INTERSECT or EXCEPT can't be the whole statement (one can be in a subquery). On the reports page, a report's filter on a view's column is added to the outer SELECT's WHERE, so on a LEFT JOINed view it also drops the rows the join didn't match. It reaches the view through the outer FROM: the view itself, or a WITH query or subquery whose SELECT returns the column under the same name or with a bare *. The widget skips a filter it can't reach that way, such as through a renamed or aggregated column, a v.*, or a UNION, and one on a view the outer FROM reads twice. There, a viewer who sees only their own accounts reads every report view in it limited to those accounts, wherever it is named (people_internal_view, your workspace's own people, belongs to no account and isn't limited). What is saved is the checked statement, as POST /v1/reports/query returns it in `sql`: without comments or your workspace's schema name, with some spellings normalized","uniqueKey":"sql.oneOf.1","typeLabel":"null"}],"uniqueKey":"sql","typeLabel":"string | null"},"text":{"oneOf":[{"type":"string","title":"Text","description":"For a text widget: its content","maxLength":20000,"uniqueKey":"text.oneOf.0","typeLabel":"string"},{"type":"null","title":"Text","description":"For a text widget: its content","uniqueKey":"text.oneOf.1","typeLabel":"null"}],"uniqueKey":"text","typeLabel":"string | null"}},"required":["type","title"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","chart":{"colors":["\u003cstring>"],"currency_symbol":"\u003cstring>","decimal_digits":10,"max_series":2,"page_size":2,"pivot_column":"\u003cstring>","series_column":"\u003cstring>","show_data_labels":true,"show_legend":true,"stacked":true,"value_column":"\u003cstring>","x_axis":"\u003cstring>","y_axis":["\u003cstring>"]},"markdown":true,"position":{"h":50,"w":6,"x":5,"y":5000},"sql":"\u003cstring>","text":"\u003cstring>"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"7a9d1d3d-d9e8-492a-a5e8-b98fea498e03":{"content":{"application/json":{"schema":{"properties":{"built_with":{"description":"sql (it runs SQL: `sql` holds it), builder (made with the visual query builder; the API doesn't return its query), or text (a text widget: `text` holds it)","enum":["sql","builder","text"],"title":"Built With","type":"string","isRequired":true,"uniqueKey":"built_with","typeLabel":"enum\u003cstring>"},"chart":{"description":"A widget's display settings, as the reports page stores them.","properties":{"colors":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"chart.colors.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Colors","description":"The palette, as CSS colors","uniqueKey":"chart.colors.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Colors","description":"The palette, as CSS colors","uniqueKey":"chart.colors.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.colors","typeLabel":"string[] | null"},"compact_notation":{"oneOf":[{"type":"string","title":"Compact Notation","enum":["K","M","B","T"],"uniqueKey":"chart.compact_notation.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Compact Notation","uniqueKey":"chart.compact_notation.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.compact_notation","typeLabel":"enum\u003cstring> | null"},"currency_symbol":{"oneOf":[{"type":"string","title":"Currency Symbol","uniqueKey":"chart.currency_symbol.oneOf.0","typeLabel":"string"},{"type":"null","title":"Currency Symbol","uniqueKey":"chart.currency_symbol.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.currency_symbol","typeLabel":"string | null"},"decimal_digits":{"oneOf":[{"type":"integer","title":"Decimal Digits","maximum":20,"minimum":0,"uniqueKey":"chart.decimal_digits.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Decimal Digits","uniqueKey":"chart.decimal_digits.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.decimal_digits","typeLabel":"integer | null"},"max_series":{"oneOf":[{"type":"integer","title":"Max Series","description":"Show the top N series by total","minimum":1,"uniqueKey":"chart.max_series.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Max Series","description":"Show the top N series by total","uniqueKey":"chart.max_series.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.max_series","typeLabel":"integer | null"},"orientation":{"oneOf":[{"type":"string","title":"Orientation","enum":["vertical","horizontal"],"uniqueKey":"chart.orientation.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Orientation","uniqueKey":"chart.orientation.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.orientation","typeLabel":"enum\u003cstring> | null"},"page_size":{"oneOf":[{"type":"integer","title":"Page Size","description":"A table's rows per page","minimum":1,"uniqueKey":"chart.page_size.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Page Size","description":"A table's rows per page","uniqueKey":"chart.page_size.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.page_size","typeLabel":"integer | null"},"pivot_column":{"oneOf":[{"type":"string","title":"Pivot Column","description":"A table's column whose values become columns","uniqueKey":"chart.pivot_column.oneOf.0","typeLabel":"string"},{"type":"null","title":"Pivot Column","description":"A table's column whose values become columns","uniqueKey":"chart.pivot_column.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.pivot_column","typeLabel":"string | null"},"series_column":{"oneOf":[{"type":"string","title":"Series Column","description":"A column whose values split the data into series","uniqueKey":"chart.series_column.oneOf.0","typeLabel":"string"},{"type":"null","title":"Series Column","description":"A column whose values split the data into series","uniqueKey":"chart.series_column.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.series_column","typeLabel":"string | null"},"show_data_labels":{"oneOf":[{"type":"boolean","title":"Show Data Labels","uniqueKey":"chart.show_data_labels.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Show Data Labels","uniqueKey":"chart.show_data_labels.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.show_data_labels","typeLabel":"boolean | null"},"show_legend":{"oneOf":[{"type":"boolean","title":"Show Legend","uniqueKey":"chart.show_legend.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Show Legend","uniqueKey":"chart.show_legend.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.show_legend","typeLabel":"boolean | null"},"stacked":{"oneOf":[{"type":"boolean","title":"Stacked","uniqueKey":"chart.stacked.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Stacked","uniqueKey":"chart.stacked.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.stacked","typeLabel":"boolean | null"},"value_column":{"oneOf":[{"type":"string","title":"Value Column","description":"The column a pivot spreads","uniqueKey":"chart.value_column.oneOf.0","typeLabel":"string"},{"type":"null","title":"Value Column","description":"The column a pivot spreads","uniqueKey":"chart.value_column.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.value_column","typeLabel":"string | null"},"value_format":{"oneOf":[{"type":"string","title":"Value Format","description":"How the widget's values read: a metric's value, a chart's axis","enum":["number","currency","percent","compact"],"uniqueKey":"chart.value_format.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Value Format","description":"How the widget's values read: a metric's value, a chart's axis","uniqueKey":"chart.value_format.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.value_format","typeLabel":"enum\u003cstring> | null"},"x_axis":{"oneOf":[{"type":"string","title":"X Axis","description":"The column on the x axis","uniqueKey":"chart.x_axis.oneOf.0","typeLabel":"string"},{"type":"null","title":"X Axis","description":"The column on the x axis","uniqueKey":"chart.x_axis.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.x_axis","typeLabel":"string | null"},"y_axis":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"chart.y_axis.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Y Axis","description":"The columns plotted, one series each","uniqueKey":"chart.y_axis.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Y Axis","description":"The columns plotted, one series each","uniqueKey":"chart.y_axis.oneOf.1","typeLabel":"null"}],"uniqueKey":"chart.y_axis","typeLabel":"string[] | null"}},"title":"ReportChart","type":"object","isRequired":true,"uniqueKey":"chart","typeLabel":"ReportChart · object"},"id":{"title":"Id","type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"position":{"oneOf":[{"type":"object","title":"ReportWidgetPosition","description":"Where it sits on the report's grid; null if what's stored can't be read","required":["x","y","w","h"],"properties":{"h":{"description":"Height, in rows","minimum":1,"title":"H","type":"integer","isRequired":true,"uniqueKey":"position.oneOf.0.h","typeLabel":"integer"},"w":{"description":"Width, in columns","minimum":1,"title":"W","type":"integer","isRequired":true,"uniqueKey":"position.oneOf.0.w","typeLabel":"integer"},"x":{"description":"Columns from the left of the report's grid","minimum":0,"title":"X","type":"integer","isRequired":true,"uniqueKey":"position.oneOf.0.x","typeLabel":"integer"},"y":{"description":"Rows from the top","minimum":0,"title":"Y","type":"integer","isRequired":true,"uniqueKey":"position.oneOf.0.y","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"position.oneOf.0","typeLabel":"ReportWidgetPosition · object"},{"type":"null","description":"Where it sits on the report's grid; null if what's stored can't be read","isRequired":true,"uniqueKey":"position.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"position","typeLabel":"ReportWidgetPosition · object | null"},"title":{"title":"Title","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"type":{"description":"metric, bar_chart, line_chart, area_chart, pie_chart, scatter_chart, table or text","title":"Type","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"markdown":{"oneOf":[{"type":"boolean","title":"Markdown","description":"A text widget's Markdown option: true shows `text` as Markdown, false as plain text","uniqueKey":"markdown.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Markdown","description":"A text widget's Markdown option: true shows `text` as Markdown, false as plain text","uniqueKey":"markdown.oneOf.1","typeLabel":"null"}],"uniqueKey":"markdown","typeLabel":"boolean | null"},"sql":{"oneOf":[{"type":"string","title":"Sql","description":"The widget's SQL as saved in the app: it may have comments or your workspace's schema name. On the reports page it runs with the report's filters and the viewer's scope added, under the app's own checks, so POST /v1/reports/query may refuse it or return different rows","uniqueKey":"sql.oneOf.0","typeLabel":"string"},{"type":"null","title":"Sql","description":"The widget's SQL as saved in the app: it may have comments or your workspace's schema name. On the reports page it runs with the report's filters and the viewer's scope added, under the app's own checks, so POST /v1/reports/query may refuse it or return different rows","uniqueKey":"sql.oneOf.1","typeLabel":"null"}],"uniqueKey":"sql","typeLabel":"string | null"},"text":{"oneOf":[{"type":"string","title":"Text","description":"A text widget's content. The app shows it as Markdown when the widget's Markdown option is on (new text widgets have it on), otherwise as plain text","uniqueKey":"text.oneOf.0","typeLabel":"string"},{"type":"null","title":"Text","description":"A text widget's content. The app shows it as Markdown when the widget's Markdown option is on (new text widgets have it on), otherwise as plain text","uniqueKey":"text.oneOf.1","typeLabel":"null"}],"uniqueKey":"text","typeLabel":"string | null"}},"required":["id","title","type","built_with","chart","position"],"title":"ReportWidget","type":"object","uniqueKey":"","typeLabel":"ReportWidget · object"},"examples":{"Example":{"title":"Example","value":{"built_with":"sql","chart":{"colors":["\u003cstring>"],"compact_notation":"K","currency_symbol":"\u003cstring>","decimal_digits":10,"max_series":2,"orientation":"vertical","page_size":2,"pivot_column":"\u003cstring>","series_column":"\u003cstring>","show_data_labels":true,"show_legend":true,"stacked":true,"value_column":"\u003cstring>","value_format":"number","x_axis":"\u003cstring>","y_axis":["\u003cstring>"]},"id":"\u003cstring>","position":{"h":2,"w":2,"x":1,"y":1},"title":"\u003cstring>","type":"\u003cstring>","markdown":true,"sql":"\u003cstring>","text":"\u003cstring>"}}},"exampleType":"generated"}},"description":"Successful Response","exampleType":"generated"}},"security":{"42f8b5be-5ab7-4163-8c6b-da6c8db547ae":{"HTTPBearer":{"scheme":"bearer","type":"http","description":"An API key, sent as `Authorization: Bearer stfy_live_…`. See [Authentication](/rest-api/authentication) for how to get one and which scopes it needs.","scopes":[],"schemeName":"HTTPBearer"}}},"servers":{"96d28bbe-8b23-4fbd-b189-be6b2ecb3cdc":{"url":"https://api.statisfy.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"scheme":"bearer","type":"http","description":"An API key, sent as `Authorization: Bearer stfy_live_…`. See [Authentication](/rest-api/authentication) for how to get one and which scopes it needs.","scopes":[],"schemeName":"HTTPBearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An API key, sent as `Authorization: Bearer stfy_live_…`. See [Authentication](/rest-api/authentication) for how to get one and which scopes it needs.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"HTTPBearer","name":"Authorization"}],"title":"HTTPBearer"}]},"originalFileLocation":"api/statisfy-api.openapi.json"},"subdomain":"statisfy","siteName":"Statisfy","title":"Add a widget to a report - Statisfy","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T12:09:55.413Z","originalFileLocation":"rest-api/reference/reports/add-a-widget-to-a-report.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Adds a widget: a chart, metric or table that runs SQL (see sql), or a text widget. Left without a position, it goes at the left below the lowest widget, sized as the reports page sizes a new one. A 409 with Retry-After means another change held the report, so nothing was written: send it again.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Statisfy\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/statisfy/ZxOxPYgd4D__ShIN/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/statisfy/ZxOxPYgd4D__ShIN/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/statisfy/ZxOxPYgd4D__ShIN/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/statisfy/ZxOxPYgd4D__ShIN/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/statisfy/ZxOxPYgd4D__ShIN/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/statisfy/ZxOxPYgd4D__ShIN/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/statisfy/ZxOxPYgd4D__ShIN/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/statisfy/ZxOxPYgd4D__ShIN/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/statisfy/ZxOxPYgd4D__ShIN/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Add a widget to a report - Statisfy\">\u003cmeta data-mint-head property=\"og:description\" content=\"Adds a widget: a chart, metric or table that runs SQL (see sql), or a text widget. Left without a position, it goes at the left below the lowest widget, sized as the reports page sizes a new one. A 409 with Retry-After means another change held the report, so nothing was written: send it again.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Statisfy\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://help.statisfy.com/rest-api/reference/reports/add-a-widget-to-a-report\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://statisfy.mintlify.site/_mintlify/api/og/v2?division=reports\u0026amp;title=Add+a+widget+to+a+report\u0026amp;description=Adds+a+widget%3A+a+chart%2C+metric+or+table+that+runs+SQL+%28see+%60sql%60%29%2C+or+a+text+widget.+Left+without+a+position%2C+it+goes+at+the+left+below+the+lowest+widget%2C+sized\u0026amp;theme=d0d553b77df82a6b94d02599\u0026amp;signature=3443f12fe0b63724f137e299710aa585b88ae4f64ea7381c506c67401e5985fc\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Add a widget to a report - Statisfy\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Adds a widget: a chart, metric or table that runs SQL (see sql), or a text widget. Left without a position, it goes at the left below the lowest widget, sized as the reports page sizes a new one. A 409 with Retry-After means another change held the report, so nothing was written: send it again.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://statisfy.mintlify.site/_mintlify/api/og/v2?division=reports\u0026amp;title=Add+a+widget+to+a+report\u0026amp;description=Adds+a+widget%3A+a+chart%2C+metric+or+table+that+runs+SQL+%28see+%60sql%60%29%2C+or+a+text+widget.+Left+without+a+position%2C+it+goes+at+the+left+below+the+lowest+widget%2C+sized\u0026amp;theme=d0d553b77df82a6b94d02599\u0026amp;signature=3443f12fe0b63724f137e299710aa585b88ae4f64ea7381c506c67401e5985fc\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/statisfy/ZxOxPYgd4D__ShIN/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Statisfy\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://help.statisfy.com/rest-api/reference/reports/add-a-widget-to-a-report\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/rest-api/reference/reports/add-a-widget-to-a-report.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://help.statisfy.com/#organization\",\"name\":\"Statisfy\",\"url\":\"https://help.statisfy.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/statisfy/-mEFnxVd9s5kL3ir/resources/logo-light.svg?fit=max\u0026auto=format\u0026n=-mEFnxVd9s5kL3ir\u0026q=85\u0026s=c42ea5d3e828945c05d618cdb0f658b9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://help.statisfy.com#website\",\"name\":\"Statisfy\",\"url\":\"https://help.statisfy.com\",\"publisher\":{\"@id\":\"https://help.statisfy.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://help.statisfy.com/rest-api/reference/reports/add-a-widget-to-a-report#webpage\",\"url\":\"https://help.statisfy.com/rest-api/reference/reports/add-a-widget-to-a-report\",\"name\":\"Add a widget to a report\",\"description\":\"Adds a widget: a chart, metric or table that runs SQL (see sql), or a text widget. Left without a position, it goes at the left below the lowest widget, sized as the reports page sizes a new one. A 409 with Retry-After means another change held the report, so nothing was written: send it again.\",\"dateModified\":\"2026-11-17T12:09:55.413Z\",\"isPartOf\":{\"@id\":\"https://help.statisfy.com#website\"},\"breadcrumb\":{\"@id\":\"https://help.statisfy.com/rest-api/reference/reports/add-a-widget-to-a-report#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://help.statisfy.com/rest-api/reference/reports/add-a-widget-to-a-report#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://help.statisfy.com/rest-api/reference/activities/list-activities\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"reports\",\"item\":\"https://help.statisfy.com/rest-api/reference/reports/list-reports\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Add a widget to a report\",\"item\":\"https://help.statisfy.com/rest-api/reference/reports/add-a-widget-to-a-report\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://help.statisfy.com/rest-api/reference/reports/add-a-widget-to-a-report#apireference\",\"headline\":\"Add a widget to a report\",\"name\":\"Add a widget to a report\",\"description\":\"Adds a widget: a chart, metric or table that runs SQL (see sql), or a text widget. Left without a position, it goes at the left below the lowest widget, sized as the reports page sizes a new one. A 409 with Retry-After means another change held the report, so nothing was written: send it again.\",\"url\":\"https://help.statisfy.com/rest-api/reference/reports/add-a-widget-to-a-report\",\"mainEntityOfPage\":{\"@id\":\"https://help.statisfy.com/rest-api/reference/reports/add-a-widget-to-a-report#webpage\"},\"dateModified\":\"2026-11-17T12:09:55.413Z\",\"publisher\":{\"@id\":\"https://help.statisfy.com/#organization\"},\"isPartOf\":{\"@id\":\"https://help.statisfy.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Statisfy\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Statisfy\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/rest-api/reference/reports/add-a-widget-to-a-report.md","siteName":"Statisfy","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/getting-started/introduction"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/salesforce"}]},{"tab":"Agent Studio","pages":[{"title":"Agent Studio","href":"/agent-studio/overview"}]},{"tab":"Admin","pages":[{"title":"Admin","href":"/admin/user_management_and_roles_guide"}]},{"tab":"Resources","pages":[{"title":"Resources","href":"/resources/faq"}]},{"tab":"AI Sales","hidden":true,"pages":[{"title":"AI Sales","href":"/ai-sales/overview"}]},{"tab":"Statisfy API","groups":[{"group":"Guides","pages":[{"title":"Statisfy API overview","href":"/rest-api/overview"},{"title":"Authentication","href":"/rest-api/authentication"},{"title":"Working with the API","href":"/rest-api/requests"},{"title":"Survey definition and theme","href":"/rest-api/survey_definition"}]},{"group":"Endpoints","pages":[{"group":"activities","pages":[{"title":"List activities","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/activities","href":"/rest-api/reference/activities/list-activities"},{"title":"Push an activity","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json put /v1/activities","href":"/rest-api/reference/activities/push-an-activity"},{"title":"Push activities","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/activities/batch/upsert","href":"/rest-api/reference/activities/push-activities"},{"title":"Get one activity","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/activities/{activity_id}","href":"/rest-api/reference/activities/get-one-activity"},{"title":"Delete a pushed activity","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/activities/{activity_id}","href":"/rest-api/reference/activities/delete-a-pushed-activity"},{"title":"Get what was written in an activity","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/activities/{activity_id}/content","href":"/rest-api/reference/activities/get-what-was-written-in-an-activity"}]},{"group":"agents","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/agents","href":"/rest-api/reference/agents/list-agents"},{"title":"Get one agent","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/agents/{agent_id}","href":"/rest-api/reference/agents/get-one-agent"}]},{"group":"approvals","pages":[{"title":"List approvals","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/approvals","href":"/rest-api/reference/approvals/list-approvals"},{"title":"Approve or reject approvals (your own key)","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/approvals/decisions","href":"/rest-api/reference/approvals/approve-or-reject-approvals-your-own-key"},{"title":"Get one approval with what it would send","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/approvals/{approval_id}","href":"/rest-api/reference/approvals/get-one-approval-with-what-it-would-send"},{"title":"Edit a pending approval before deciding (your own key)","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/approvals/{approval_id}","href":"/rest-api/reference/approvals/edit-a-pending-approval-before-deciding-your-own-key"},{"title":"Read an approval's attachment","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/approvals/{approval_id}/attachments/{attachment_id}","href":"/rest-api/reference/approvals/read-an-approvals-attachment"}]},{"group":"audit_logs","pages":[{"title":"List audit events","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/audit-logs","href":"/rest-api/reference/audit_logs/list-audit-events"},{"title":"Search audit events","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/audit-logs/search","href":"/rest-api/reference/audit_logs/search-audit-events"}]},{"group":"automations","pages":[{"title":"List the steps a flow can use","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/automations/components","href":"/rest-api/reference/automations/list-the-steps-a-flow-can-use"},{"title":"Get one step's settings and the fields it returns","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/automations/components/{component}","href":"/rest-api/reference/automations/get-one-steps-settings-and-the-fields-it-returns"},{"title":"List the workspace's options for a step's dropdown","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/automations/components/{component}/options/{setting}","href":"/rest-api/reference/automations/list-the-workspaces-options-for-a-steps-dropdown"},{"title":"Get how to write each of a step's settings","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/automations/components/{component}/settings","href":"/rest-api/reference/automations/get-how-to-write-each-of-a-steps-settings"},{"title":"List flows","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/automations/flows","href":"/rest-api/reference/automations/list-flows"},{"title":"Create a flow from a spec, off","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/automations/flows","href":"/rest-api/reference/automations/create-a-flow-from-a-spec-off"},{"title":"Get one flow","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/automations/flows/{flow_id}","href":"/rest-api/reference/automations/get-one-flow"},{"title":"Replace a flow's spec","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json put /v1/automations/flows/{flow_id}","href":"/rest-api/reference/automations/replace-a-flows-spec"},{"title":"Delete a flow that is off","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/automations/flows/{flow_id}","href":"/rest-api/reference/automations/delete-a-flow-that-is-off"},{"title":"Turn a flow off","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/automations/flows/{flow_id}/disable","href":"/rest-api/reference/automations/turn-a-flow-off"},{"title":"Turn a flow on (admins)","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/automations/flows/{flow_id}/enable","href":"/rest-api/reference/automations/turn-a-flow-on-admins"},{"title":"What turning a flow on will do","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/automations/flows/{flow_id}/enable-preview","href":"/rest-api/reference/automations/what-turning-a-flow-on-will-do"},{"title":"Get any flow as a spec, including one built in the editor","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/automations/flows/{flow_id}/spec","href":"/rest-api/reference/automations/get-any-flow-as-a-spec-including-one-built-in-the-editor"},{"title":"Run a flow up to a step on a real record, in a sandbox","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/automations/flows/{flow_id}/test","href":"/rest-api/reference/automations/run-a-flow-up-to-a-step-on-a-real-record-in-a-sandbox"},{"title":"How to build, test and turn on an automation (an Agent Studio flow or workflow)","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/automations/guide","href":"/rest-api/reference/automations/how-to-build-test-and-turn-on-an-automation-an-agent-studio-flow-or-workflow"},{"title":"List account roles a step can address (CSM, owner)","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/automations/roles","href":"/rest-api/reference/automations/list-account-roles-a-step-can-address-csm-owner"},{"title":"List flow runs","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/automations/runs","href":"/rest-api/reference/automations/list-flow-runs"},{"title":"Get one flow run","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/automations/runs/{run_id}","href":"/rest-api/reference/automations/get-one-flow-run"},{"title":"List the shapes a step's settings take","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/automations/shapes","href":"/rest-api/reference/automations/list-the-shapes-a-steps-settings-take"},{"title":"Get one value shape's JSON Schema","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/automations/shapes/{shape}","href":"/rest-api/reference/automations/get-one-value-shapes-json-schema"},{"title":"List flow templates","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/automations/templates","href":"/rest-api/reference/automations/list-flow-templates"},{"title":"Save a flow of the Templates folder as a template","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/automations/templates","href":"/rest-api/reference/automations/save-a-flow-of-the-templates-folder-as-a-template"},{"title":"List flow template categories","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/automations/templates/categories","href":"/rest-api/reference/automations/list-flow-template-categories"},{"title":"Get one flow template","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/automations/templates/{template_id}","href":"/rest-api/reference/automations/get-one-flow-template"},{"title":"Delete a flow template","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/automations/templates/{template_id}","href":"/rest-api/reference/automations/delete-a-flow-template"},{"title":"Change a flow template's categories","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/automations/templates/{template_id}","href":"/rest-api/reference/automations/change-a-flow-templates-categories"},{"title":"Create a flow from a template, off","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/automations/templates/{template_id}/flows","href":"/rest-api/reference/automations/create-a-flow-from-a-template-off"},{"title":"List workflows","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/automations/workflows","href":"/rest-api/reference/automations/list-workflows"},{"title":"Get one workflow","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/automations/workflows/{workflow_id}","href":"/rest-api/reference/automations/get-one-workflow"}]},{"group":"campaigns","pages":[{"title":"List campaigns","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/campaigns","href":"/rest-api/reference/campaigns/list-campaigns"},{"title":"Create a campaign","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/campaigns","href":"/rest-api/reference/campaigns/create-a-campaign"},{"title":"List audiences","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/campaigns/audiences","href":"/rest-api/reference/campaigns/list-audiences"},{"title":"List account roles","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/campaigns/roles","href":"/rest-api/reference/campaigns/list-account-roles"},{"title":"Get one campaign","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/campaigns/{campaign_id}","href":"/rest-api/reference/campaigns/get-one-campaign"},{"title":"Delete a campaign","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/campaigns/{campaign_id}","href":"/rest-api/reference/campaigns/delete-a-campaign"},{"title":"Change a campaign","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/campaigns/{campaign_id}","href":"/rest-api/reference/campaigns/change-a-campaign"},{"title":"Publish a campaign","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/campaigns/{campaign_id}/publish","href":"/rest-api/reference/campaigns/publish-a-campaign"},{"title":"List a campaign's recipients","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/campaigns/{campaign_id}/recipients","href":"/rest-api/reference/campaigns/list-a-campaigns-recipients"},{"title":"Get a campaign's numbers","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/campaigns/{campaign_id}/stats","href":"/rest-api/reference/campaigns/get-a-campaigns-numbers"},{"title":"Send a test email","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/campaigns/{campaign_id}/test-email","href":"/rest-api/reference/campaigns/send-a-test-email"},{"title":"Unpublish (pause) a campaign","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/campaigns/{campaign_id}/unpublish","href":"/rest-api/reference/campaigns/unpublish-pause-a-campaign"}]},{"group":"clips","pages":[{"title":"List clips","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/clips","href":"/rest-api/reference/clips/list-clips"},{"title":"Create a clip","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/clips","href":"/rest-api/reference/clips/create-a-clip"},{"title":"Get one clip","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/clips/{clip_id}","href":"/rest-api/reference/clips/get-one-clip"},{"title":"Delete a clip","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/clips/{clip_id}","href":"/rest-api/reference/clips/delete-a-clip"},{"title":"Change a clip","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/clips/{clip_id}","href":"/rest-api/reference/clips/change-a-clip"},{"title":"Share a clip","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/clips/{clip_id}/share","href":"/rest-api/reference/clips/share-a-clip"}]},{"group":"comments","pages":[{"title":"Get one comment","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/comments/{comment_id}","href":"/rest-api/reference/comments/get-one-comment"},{"title":"Delete a comment","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/comments/{comment_id}","href":"/rest-api/reference/comments/delete-a-comment"},{"title":"Edit a comment","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/comments/{comment_id}","href":"/rest-api/reference/comments/edit-a-comment"},{"title":"List a project's comments","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/objects/project/records/{project_id}/comments","href":"/rest-api/reference/comments/list-a-projects-comments"},{"title":"Comment on a project","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/project/records/{project_id}/comments","href":"/rest-api/reference/comments/comment-on-a-project"},{"title":"List a task's comments","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/objects/task/records/{task_id}/comments","href":"/rest-api/reference/comments/list-a-tasks-comments"},{"title":"Comment on a task","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/task/records/{task_id}/comments","href":"/rest-api/reference/comments/comment-on-a-task"}]},{"group":"conversations","pages":[{"title":"List conversations","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/conversations","href":"/rest-api/reference/conversations/list-conversations"},{"title":"Get one conversation","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/conversations/{conversation_id}","href":"/rest-api/reference/conversations/get-one-conversation"},{"title":"List a conversation's messages","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/conversations/{conversation_id}/messages","href":"/rest-api/reference/conversations/list-a-conversations-messages"},{"title":"List a conversation's internal notes","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/conversations/{conversation_id}/notes","href":"/rest-api/reference/conversations/list-a-conversations-internal-notes"}]},{"group":"credits","pages":[{"title":"List AI credit usage by flow","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/credits/flows","href":"/rest-api/reference/credits/list-ai-credit-usage-by-flow"},{"title":"List the AI credit usage log","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/credits/log","href":"/rest-api/reference/credits/list-the-ai-credit-usage-log"},{"title":"Get the AI credit summary","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/credits/summary","href":"/rest-api/reference/credits/get-the-ai-credit-summary"}]},{"group":"digital_workers","pages":[{"title":"List digital workers","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/digital_workers","href":"/rest-api/reference/digital_workers/list-digital-workers"},{"title":"Create a digital worker","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/digital_workers","href":"/rest-api/reference/digital_workers/create-a-digital-worker"},{"title":"Get one digital worker","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/digital_workers/{worker_id}","href":"/rest-api/reference/digital_workers/get-one-digital-worker"},{"title":"Change, activate, stop or archive a digital worker","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/digital_workers/{worker_id}","href":"/rest-api/reference/digital_workers/change-activate-stop-or-archive-a-digital-worker"},{"title":"List the accounts a worker covers","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/digital_workers/{worker_id}/accounts","href":"/rest-api/reference/digital_workers/list-the-accounts-a-worker-covers"},{"title":"Try a worker on one message","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/digital_workers/{worker_id}/preview","href":"/rest-api/reference/digital_workers/try-a-worker-on-one-message"},{"title":"List a worker's proactive tasks","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/digital_workers/{worker_id}/tasks","href":"/rest-api/reference/digital_workers/list-a-workers-proactive-tasks"},{"title":"Add a proactive task","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/digital_workers/{worker_id}/tasks","href":"/rest-api/reference/digital_workers/add-a-proactive-task"},{"title":"Get one proactive task","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/digital_workers/{worker_id}/tasks/{task_id}","href":"/rest-api/reference/digital_workers/get-one-proactive-task"},{"title":"Delete a proactive task","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/digital_workers/{worker_id}/tasks/{task_id}","href":"/rest-api/reference/digital_workers/delete-a-proactive-task"},{"title":"Change or close a proactive task","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/digital_workers/{worker_id}/tasks/{task_id}","href":"/rest-api/reference/digital_workers/change-or-close-a-proactive-task"},{"title":"See what a proactive task did this period","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/digital_workers/{worker_id}/tasks/{task_id}/coverage","href":"/rest-api/reference/digital_workers/see-what-a-proactive-task-did-this-period"},{"title":"List a worker's saved versions","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/digital_workers/{worker_id}/versions","href":"/rest-api/reference/digital_workers/list-a-workers-saved-versions"},{"title":"Restore a saved version","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/digital_workers/{worker_id}/versions/{version_id}/restore","href":"/rest-api/reference/digital_workers/restore-a-saved-version"}]},{"group":"evaluations","pages":[{"title":"List a worker's sets","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/evaluations/case_sets","href":"/rest-api/reference/evaluations/list-a-workers-sets"},{"title":"Create a set of test situations","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/evaluations/case_sets","href":"/rest-api/reference/evaluations/create-a-set-of-test-situations"},{"title":"Read a set and its cases","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/evaluations/case_sets/{case_set_id}","href":"/rest-api/reference/evaluations/read-a-set-and-its-cases"},{"title":"Score one result","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/evaluations/results/score","href":"/rest-api/reference/evaluations/score-one-result"},{"title":"List a worker's runs","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/evaluations/runs","href":"/rest-api/reference/evaluations/list-a-workers-runs"},{"title":"Start a run","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/evaluations/runs","href":"/rest-api/reference/evaluations/start-a-run"},{"title":"Read a run","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/evaluations/runs/{run_id}","href":"/rest-api/reference/evaluations/read-a-run"},{"title":"Read what a run produced","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/evaluations/runs/{run_id}/results","href":"/rest-api/reference/evaluations/read-what-a-run-produced"}]},{"group":"fields","pages":[{"title":"List every field definition on an object (the describe API)","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/fields","href":"/rest-api/reference/fields/list-every-field-definition-on-an-object-the-describe-api"},{"title":"Create a custom field definition on an object","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/fields","href":"/rest-api/reference/fields/create-a-custom-field-definition-on-an-object"},{"title":"Get one field definition by key","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/fields/{field_key}","href":"/rest-api/reference/fields/get-one-field-definition-by-key"},{"title":"Delete a custom field","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/fields/{field_key}","href":"/rest-api/reference/fields/delete-a-custom-field"},{"title":"Update a field definition's display name, visibility, or requiredness","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/fields/{field_key}","href":"/rest-api/reference/fields/update-a-field-definitions-display-name-visibility-or-requiredness"},{"title":"Replace the picklist options of a text picklist field","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json put /v1/fields/{field_key}/options","href":"/rest-api/reference/fields/replace-the-picklist-options-of-a-text-picklist-field"},{"title":"Recompute a formula field on every record","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/fields/{field_key}/recompute","href":"/rest-api/reference/fields/recompute-a-formula-field-on-every-record"},{"title":"List the functions a formula expression can use","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/formulas/functions","href":"/rest-api/reference/fields/list-the-functions-a-formula-expression-can-use"},{"title":"Compute a formula on a few records without saving it","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/formulas/preview","href":"/rest-api/reference/fields/compute-a-formula-on-a-few-records-without-saving-it"},{"title":"Check a formula before you save it","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/formulas/validate","href":"/rest-api/reference/fields/check-a-formula-before-you-save-it"}]},{"group":"health","pages":[{"title":"List account health","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/health","href":"/rest-api/reference/health/list-account-health"}]},{"group":"integrations","pages":[{"title":"List integrations","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations","href":"/rest-api/reference/integrations/list-integrations"},{"title":"List file imports","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/imports","href":"/rest-api/reference/integrations/list-file-imports"},{"title":"List file import feeds","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/imports/feeds","href":"/rest-api/reference/integrations/list-file-import-feeds"},{"title":"Create a file import feed","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/integrations/imports/feeds","href":"/rest-api/reference/integrations/create-a-file-import-feed"},{"title":"Get one file import feed","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/imports/feeds/{name}","href":"/rest-api/reference/integrations/get-one-file-import-feed"},{"title":"Delete a file import feed","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/integrations/imports/feeds/{name}","href":"/rest-api/reference/integrations/delete-a-file-import-feed"},{"title":"Change a file import feed","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/integrations/imports/feeds/{name}","href":"/rest-api/reference/integrations/change-a-file-import-feed"},{"title":"Import one file now with a feed","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/integrations/imports/feeds/{name}/run","href":"/rest-api/reference/integrations/import-one-file-now-with-a-feed"},{"title":"Read a sample file's columns","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/integrations/imports/sample","href":"/rest-api/reference/integrations/read-a-sample-files-columns"},{"title":"List where a file's columns can go","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/imports/targets","href":"/rest-api/reference/integrations/list-where-a-files-columns-can-go"},{"title":"Test a feed's mapping on a sample","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/integrations/imports/test","href":"/rest-api/reference/integrations/test-a-feeds-mapping-on-a-sample"},{"title":"Get one file import","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/imports/{import_id}","href":"/rest-api/reference/integrations/get-one-file-import"},{"title":"List the Pendo account fields","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/pendo/account-fields","href":"/rest-api/reference/integrations/list-the-pendo-account-fields"},{"title":"List Pendo pages, features, track types or apps","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/pendo/catalog/{kind}","href":"/rest-api/reference/integrations/list-pendo-pages-features-track-types-or-apps"},{"title":"Get the Pendo config","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/pendo/config","href":"/rest-api/reference/integrations/get-the-pendo-config"},{"title":"Change the Pendo config","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/integrations/pendo/config","href":"/rest-api/reference/integrations/change-the-pendo-config"},{"title":"Preview a Pendo query","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/integrations/pendo/preview","href":"/rest-api/reference/integrations/preview-a-pendo-query"},{"title":"List the saved Pendo queries","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/pendo/queries","href":"/rest-api/reference/integrations/list-the-saved-pendo-queries"},{"title":"Save a new Pendo query","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/integrations/pendo/queries","href":"/rest-api/reference/integrations/save-a-new-pendo-query"},{"title":"Get one saved Pendo query","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/pendo/queries/{query_id}","href":"/rest-api/reference/integrations/get-one-saved-pendo-query"},{"title":"Delete a saved Pendo query","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/integrations/pendo/queries/{query_id}","href":"/rest-api/reference/integrations/delete-a-saved-pendo-query"},{"title":"Change a saved Pendo query","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/integrations/pendo/queries/{query_id}","href":"/rest-api/reference/integrations/change-a-saved-pendo-query"},{"title":"Check a Pendo query","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/integrations/pendo/query/validate","href":"/rest-api/reference/integrations/check-a-pendo-query"},{"title":"List the Pendo reports","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/pendo/reports","href":"/rest-api/reference/integrations/list-the-pendo-reports"},{"title":"List the Pendo NPS guides","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/pendo/surveys","href":"/rest-api/reference/integrations/list-the-pendo-nps-guides"},{"title":"Count the NPS answers of Pendo guides","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/pendo/surveys/answer-counts","href":"/rest-api/reference/integrations/count-the-nps-answers-of-pendo-guides"},{"title":"Preview the Pendo survey job","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/integrations/pendo/surveys/preview","href":"/rest-api/reference/integrations/preview-the-pendo-survey-job"},{"title":"Run the Pendo NPS survey job now","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/integrations/pendo/surveys/runs","href":"/rest-api/reference/integrations/run-the-pendo-nps-survey-job-now"},{"title":"Check a Pendo Sentiment survey ID","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/pendo/surveys/sentiment/{survey_id}","href":"/rest-api/reference/integrations/check-a-pendo-sentiment-survey-id"},{"title":"Get one integration","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/{key}","href":"/rest-api/reference/integrations/get-one-integration"},{"title":"List an integration's channels","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/{key}/channels","href":"/rest-api/reference/integrations/list-an-integrations-channels"},{"title":"Get one channel","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/{key}/channels/{channel_id}","href":"/rest-api/reference/integrations/get-one-channel"},{"title":"Get an integration's config","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/{key}/config","href":"/rest-api/reference/integrations/get-an-integrations-config"},{"title":"Change an integration's config","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/integrations/{key}/config","href":"/rest-api/reference/integrations/change-an-integrations-config"},{"title":"Test an integration's connection (a SQL warehouse or Pendo)","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/integrations/{key}/connection/test","href":"/rest-api/reference/integrations/test-an-integrations-connection-a-sql-warehouse-or-pendo"},{"title":"List an integration's connections","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/{key}/connections","href":"/rest-api/reference/integrations/list-an-integrations-connections"},{"title":"List a warehouse's schemas","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/{key}/discover/schemas","href":"/rest-api/reference/integrations/list-a-warehouses-schemas"},{"title":"List a schema's tables","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/{key}/discover/schemas/{schema_name}/tables","href":"/rest-api/reference/integrations/list-a-schemas-tables"},{"title":"List a table's columns","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/{key}/discover/schemas/{schema_name}/tables/{table_name}/columns","href":"/rest-api/reference/integrations/list-a-tables-columns"},{"title":"Preview a query","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/integrations/{key}/preview","href":"/rest-api/reference/integrations/preview-a-query"},{"title":"List saved queries","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/{key}/queries","href":"/rest-api/reference/integrations/list-saved-queries"},{"title":"Save a new query","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/integrations/{key}/queries","href":"/rest-api/reference/integrations/save-a-new-query"},{"title":"Get one saved query","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/{key}/queries/{query_id}","href":"/rest-api/reference/integrations/get-one-saved-query"},{"title":"Delete a saved query","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/integrations/{key}/queries/{query_id}","href":"/rest-api/reference/integrations/delete-a-saved-query"},{"title":"Change a saved query","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/integrations/{key}/queries/{query_id}","href":"/rest-api/reference/integrations/change-a-saved-query"},{"title":"List recent runs (any app, Pendo included)","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/{key}/runs","href":"/rest-api/reference/integrations/list-recent-runs-any-app-pendo-included"},{"title":"Run a saved query now (a SQL warehouse or Pendo)","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/integrations/{key}/runs","href":"/rest-api/reference/integrations/run-a-saved-query-now-a-sql-warehouse-or-pendo"},{"title":"Get one run (any app, Pendo included)","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/{key}/runs/{run_id}","href":"/rest-api/reference/integrations/get-one-run-any-app-pendo-included"},{"title":"Get an integration's schedule (any app, Pendo included)","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/integrations/{key}/schedule","href":"/rest-api/reference/integrations/get-an-integrations-schedule-any-app-pendo-included"},{"title":"Set an integration's schedule (a SQL warehouse or Pendo)","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json put /v1/integrations/{key}/schedule","href":"/rest-api/reference/integrations/set-an-integrations-schedule-a-sql-warehouse-or-pendo"},{"title":"Run SQL against the warehouse","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/integrations/{key}/sql","href":"/rest-api/reference/integrations/run-sql-against-the-warehouse"},{"title":"Check SQL","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/integrations/{key}/sql/validate","href":"/rest-api/reference/integrations/check-sql"}]},{"group":"knowledge_bases","pages":[{"title":"List knowledge bases","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/knowledge_bases","href":"/rest-api/reference/knowledge_bases/list-knowledge-bases"},{"title":"Create a knowledge base","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/knowledge_bases","href":"/rest-api/reference/knowledge_bases/create-a-knowledge-base"},{"title":"Search knowledge as a worker would","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/knowledge_bases/search","href":"/rest-api/reference/knowledge_bases/search-knowledge-as-a-worker-would"},{"title":"Get one knowledge base","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/knowledge_bases/{knowledge_base_id}","href":"/rest-api/reference/knowledge_bases/get-one-knowledge-base"},{"title":"Delete a knowledge base","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/knowledge_bases/{knowledge_base_id}","href":"/rest-api/reference/knowledge_bases/delete-a-knowledge-base"},{"title":"Change a knowledge base","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/knowledge_bases/{knowledge_base_id}","href":"/rest-api/reference/knowledge_bases/change-a-knowledge-base"},{"title":"List a knowledge base's documents","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/knowledge_bases/{knowledge_base_id}/documents","href":"/rest-api/reference/knowledge_bases/list-a-knowledge-bases-documents"},{"title":"Create or update a document","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json put /v1/knowledge_bases/{knowledge_base_id}/documents","href":"/rest-api/reference/knowledge_bases/create-or-update-a-document"},{"title":"Delete documents","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/knowledge_bases/{knowledge_base_id}/documents/batch/delete","href":"/rest-api/reference/knowledge_bases/delete-documents"},{"title":"Create or update documents","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/knowledge_bases/{knowledge_base_id}/documents/batch/upsert","href":"/rest-api/reference/knowledge_bases/create-or-update-documents"},{"title":"Get one document","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/knowledge_bases/{knowledge_base_id}/documents/{document_id}","href":"/rest-api/reference/knowledge_bases/get-one-document"},{"title":"Delete a document","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/knowledge_bases/{knowledge_base_id}/documents/{document_id}","href":"/rest-api/reference/knowledge_bases/delete-a-document"}]},{"group":"meetings","pages":[{"title":"List notetaker meetings","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/meetings","href":"/rest-api/reference/meetings/list-notetaker-meetings"},{"title":"Get one notetaker meeting","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/meetings/{meeting_id}","href":"/rest-api/reference/meetings/get-one-notetaker-meeting"},{"title":"Get a notetaker meeting's transcript files","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/meetings/{meeting_id}/transcript","href":"/rest-api/reference/meetings/get-a-notetaker-meetings-transcript-files"}]},{"group":"meta","pages":[{"title":"List every capability this API exposes, with schemas","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/meta/capabilities","href":"/rest-api/reference/meta/list-every-capability-this-api-exposes-with-schemas"},{"title":"Echo the authenticated identity behind this key","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/meta/whoami","href":"/rest-api/reference/meta/echo-the-authenticated-identity-behind-this-key"}]},{"group":"notification_rules","pages":[{"title":"List notification rules","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/notification-rules","href":"/rest-api/reference/notification_rules/list-notification-rules"},{"title":"Create a notification rule","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/notification-rules","href":"/rest-api/reference/notification_rules/create-a-notification-rule"},{"title":"List the channels a rule can send to","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/notification-rules/channels","href":"/rest-api/reference/notification_rules/list-the-channels-a-rule-can-send-to"},{"title":"Get one notification rule","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/notification-rules/{rule_id}","href":"/rest-api/reference/notification_rules/get-one-notification-rule"},{"title":"Delete a notification rule","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/notification-rules/{rule_id}","href":"/rest-api/reference/notification_rules/delete-a-notification-rule"},{"title":"Update a notification rule","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/notification-rules/{rule_id}","href":"/rest-api/reference/notification_rules/update-a-notification-rule"}]},{"group":"objects","pages":[{"title":"List the record objects","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/objects","href":"/rest-api/reference/objects/list-the-record-objects"},{"title":"Create a custom object","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects","href":"/rest-api/reference/objects/create-a-custom-object"},{"title":"Get one record object, with its fields","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/objects/{object}","href":"/rest-api/reference/objects/get-one-record-object-with-its-fields"},{"title":"Rename a custom object","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/objects/{object}","href":"/rest-api/reference/objects/rename-a-custom-object"}]},{"group":"accounts","pages":[{"title":"List accounts","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/objects/account/records","href":"/rest-api/reference/accounts/list-accounts"},{"title":"Update the matching account, or create it","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json put /v1/objects/account/records","href":"/rest-api/reference/accounts/update-the-matching-account-or-create-it"},{"title":"Create an account","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/account/records","href":"/rest-api/reference/accounts/create-an-account"},{"title":"Update up to 100 accounts, each with its own values","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/account/records/batch/update","href":"/rest-api/reference/accounts/update-up-to-100-accounts-each-with-its-own-values"},{"title":"Search accounts with AND/OR filters","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/account/records/search","href":"/rest-api/reference/accounts/search-accounts-with-andor-filters"},{"title":"Get one account","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/objects/account/records/{account_id}","href":"/rest-api/reference/accounts/get-one-account"},{"title":"Delete an account","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/objects/account/records/{account_id}","href":"/rest-api/reference/accounts/delete-an-account"},{"title":"Update an account","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/objects/account/records/{account_id}","href":"/rest-api/reference/accounts/update-an-account"}]},{"group":"contacts","pages":[{"title":"List contacts","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/objects/contact/records","href":"/rest-api/reference/contacts/list-contacts"},{"title":"Update the contact with an address, or create it","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json put /v1/objects/contact/records","href":"/rest-api/reference/contacts/update-the-contact-with-an-address-or-create-it"},{"title":"Create a contact","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/contact/records","href":"/rest-api/reference/contacts/create-a-contact"},{"title":"Update up to 100 contacts, each with its own values","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/contact/records/batch/update","href":"/rest-api/reference/contacts/update-up-to-100-contacts-each-with-its-own-values"},{"title":"Search contacts with AND/OR filters","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/contact/records/search","href":"/rest-api/reference/contacts/search-contacts-with-andor-filters"},{"title":"Get one contact","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/objects/contact/records/{contact_id}","href":"/rest-api/reference/contacts/get-one-contact"},{"title":"Update a contact","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/objects/contact/records/{contact_id}","href":"/rest-api/reference/contacts/update-a-contact"}]},{"group":"opportunities","pages":[{"title":"List opportunities","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/objects/opportunity/records","href":"/rest-api/reference/opportunities/list-opportunities"},{"title":"Update the matching opportunity, or create it","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json put /v1/objects/opportunity/records","href":"/rest-api/reference/opportunities/update-the-matching-opportunity-or-create-it"},{"title":"Create an opportunity","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/opportunity/records","href":"/rest-api/reference/opportunities/create-an-opportunity"},{"title":"Update up to 100 opportunities, each with its own values","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/opportunity/records/batch/update","href":"/rest-api/reference/opportunities/update-up-to-100-opportunities-each-with-its-own-values"},{"title":"Search opportunities with AND/OR filters","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/opportunity/records/search","href":"/rest-api/reference/opportunities/search-opportunities-with-andor-filters"},{"title":"Get one opportunity","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/objects/opportunity/records/{opportunity_id}","href":"/rest-api/reference/opportunities/get-one-opportunity"},{"title":"Delete an opportunity","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/objects/opportunity/records/{opportunity_id}","href":"/rest-api/reference/opportunities/delete-an-opportunity"},{"title":"Update an opportunity","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/objects/opportunity/records/{opportunity_id}","href":"/rest-api/reference/opportunities/update-an-opportunity"}]},{"group":"projects","pages":[{"title":"List projects","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/objects/project/records","href":"/rest-api/reference/projects/list-projects"},{"title":"Create a project","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/project/records","href":"/rest-api/reference/projects/create-a-project"},{"title":"Update up to 100 projects, each with its own values","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/project/records/batch/update","href":"/rest-api/reference/projects/update-up-to-100-projects-each-with-its-own-values"},{"title":"Search projects with AND/OR filters","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/project/records/search","href":"/rest-api/reference/projects/search-projects-with-andor-filters"},{"title":"Get one project","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/objects/project/records/{project_id}","href":"/rest-api/reference/projects/get-one-project"},{"title":"Delete a project","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/objects/project/records/{project_id}","href":"/rest-api/reference/projects/delete-a-project"},{"title":"Update a project","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/objects/project/records/{project_id}","href":"/rest-api/reference/projects/update-a-project"},{"title":"Add a custom field to a project","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json put /v1/objects/project/records/{project_id}/fields/{field_key}","href":"/rest-api/reference/projects/add-a-custom-field-to-a-project"},{"title":"Remove a custom field from a project","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/objects/project/records/{project_id}/fields/{field_key}","href":"/rest-api/reference/projects/remove-a-custom-field-from-a-project"},{"title":"List project templates","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/project_templates","href":"/rest-api/reference/projects/list-project-templates"},{"title":"Add a custom field to a project template","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json put /v1/project_templates/{template_id}/fields/{field_key}","href":"/rest-api/reference/projects/add-a-custom-field-to-a-project-template"},{"title":"Remove a custom field from a project template","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/project_templates/{template_id}/fields/{field_key}","href":"/rest-api/reference/projects/remove-a-custom-field-from-a-project-template"}]},{"group":"tasks","pages":[{"title":"List tasks","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/objects/task/records","href":"/rest-api/reference/tasks/list-tasks"},{"title":"Create a task","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/task/records","href":"/rest-api/reference/tasks/create-a-task"},{"title":"Update up to 100 tasks, each with its own values","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/task/records/batch/update","href":"/rest-api/reference/tasks/update-up-to-100-tasks-each-with-its-own-values"},{"title":"Search tasks with AND/OR filters","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/task/records/search","href":"/rest-api/reference/tasks/search-tasks-with-andor-filters"},{"title":"Get one task","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/objects/task/records/{task_id}","href":"/rest-api/reference/tasks/get-one-task"},{"title":"Delete a task","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/objects/task/records/{task_id}","href":"/rest-api/reference/tasks/delete-a-task"},{"title":"Update a task","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/objects/task/records/{task_id}","href":"/rest-api/reference/tasks/update-a-task"}]},{"group":"users","pages":[{"title":"List users","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/objects/user/records","href":"/rest-api/reference/users/list-users"},{"title":"Update up to 100 users, each with its own values","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/user/records/batch/update","href":"/rest-api/reference/users/update-up-to-100-users-each-with-its-own-values"},{"title":"Search users with AND/OR filters","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/user/records/search","href":"/rest-api/reference/users/search-users-with-andor-filters"},{"title":"Get one user","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/objects/user/records/{user_id}","href":"/rest-api/reference/users/get-one-user"},{"title":"Update a user","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/objects/user/records/{user_id}","href":"/rest-api/reference/users/update-a-user"}]},{"group":"custom_objects","pages":[{"title":"List a custom object's records","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/objects/{object}/records","href":"/rest-api/reference/custom_objects/list-a-custom-objects-records"},{"title":"Create or update a custom object record by external_id","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json put /v1/objects/{object}/records","href":"/rest-api/reference/custom_objects/create-or-update-a-custom-object-record-by-external_id"},{"title":"Create a custom object record","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/{object}/records","href":"/rest-api/reference/custom_objects/create-a-custom-object-record"},{"title":"Update many custom object records","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/{object}/records/batch/update","href":"/rest-api/reference/custom_objects/update-many-custom-object-records"},{"title":"Search a custom object's records with AND/OR filters","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/objects/{object}/records/search","href":"/rest-api/reference/custom_objects/search-a-custom-objects-records-with-andor-filters"},{"title":"Get one custom object record","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/objects/{object}/records/{record_id}","href":"/rest-api/reference/custom_objects/get-one-custom-object-record"},{"title":"Delete a custom object record","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/objects/{object}/records/{record_id}","href":"/rest-api/reference/custom_objects/delete-a-custom-object-record"},{"title":"Update a custom object record","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/objects/{object}/records/{record_id}","href":"/rest-api/reference/custom_objects/update-a-custom-object-record"}]},{"group":"outreach_emails","pages":[{"title":"List outreach emails","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/outreach_emails","href":"/rest-api/reference/outreach_emails/list-outreach-emails"},{"title":"Count outreach emails and what became of them","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/outreach_emails/stats","href":"/rest-api/reference/outreach_emails/count-outreach-emails-and-what-became-of-them"},{"title":"Get one outreach email","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/outreach_emails/{email_id}","href":"/rest-api/reference/outreach_emails/get-one-outreach-email"}]},{"group":"products","pages":[{"title":"List products and their dimensions","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/products","href":"/rest-api/reference/products/list-products-and-their-dimensions"},{"title":"Create or update a product and its dimensions","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json put /v1/products","href":"/rest-api/reference/products/create-or-update-a-product-and-its-dimensions"},{"title":"Create a product","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/products","href":"/rest-api/reference/products/create-a-product"},{"title":"Get one product and its dimensions","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/products/{product_id}","href":"/rest-api/reference/products/get-one-product-and-its-dimensions"},{"title":"Delete a product","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/products/{product_id}","href":"/rest-api/reference/products/delete-a-product"},{"title":"Update a product","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/products/{product_id}","href":"/rest-api/reference/products/update-a-product"},{"title":"Add a dimension to a product","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/products/{product_id}/dimensions","href":"/rest-api/reference/products/add-a-dimension-to-a-product"},{"title":"Delete a dimension","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/products/{product_id}/dimensions/{dimension_id}","href":"/rest-api/reference/products/delete-a-dimension"},{"title":"Update a dimension","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/products/{product_id}/dimensions/{dimension_id}","href":"/rest-api/reference/products/update-a-dimension"}]},{"group":"usage","pages":[{"title":"List a product's usage values","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/products/{product_id}/usage","href":"/rest-api/reference/usage/list-a-products-usage-values"},{"title":"Write a product's usage values","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/products/{product_id}/usage","href":"/rest-api/reference/usage/write-a-products-usage-values"}]},{"group":"reports","pages":[{"title":"List reports","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/reports","href":"/rest-api/reference/reports/list-reports"},{"title":"Create a report","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/reports","href":"/rest-api/reference/reports/create-a-report"},{"title":"Run report SQL","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/reports/query","href":"/rest-api/reference/reports/run-report-sql"},{"title":"List report views","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/reports/sources","href":"/rest-api/reference/reports/list-report-views"},{"title":"Get one report","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/reports/{report_id}","href":"/rest-api/reference/reports/get-one-report"},{"title":"Delete a report","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/reports/{report_id}","href":"/rest-api/reference/reports/delete-a-report"},{"title":"Change a report","description":"Changes a report's name, description, visibility or owner (null leaves a team report with no owner; a private report keeps one). Its widgets change through /v1/reports/{report_id}/widgets. A 409 with Retry-After means another change held the report, so nothing was written: send it again.","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/reports/{report_id}","href":"/rest-api/reference/reports/change-a-report"},{"title":"Add a widget to a report","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/reports/{report_id}/widgets","href":"/rest-api/reference/reports/add-a-widget-to-a-report"},{"title":"Delete a widget","description":"Deletes a widget from its report.","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/reports/{report_id}/widgets/{widget_id}","href":"/rest-api/reference/reports/delete-a-widget"},{"title":"Change a widget","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/reports/{report_id}/widgets/{widget_id}","href":"/rest-api/reference/reports/change-a-widget"}]},{"group":"sender_domains","pages":[{"title":"List sender domains","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/sender-domains","href":"/rest-api/reference/sender_domains/list-sender-domains"},{"title":"Add a sender domain","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/sender-domains","href":"/rest-api/reference/sender_domains/add-a-sender-domain"},{"title":"Get one sender domain","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/sender-domains/{domain}","href":"/rest-api/reference/sender_domains/get-one-sender-domain"},{"title":"Remove a sender domain","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/sender-domains/{domain}","href":"/rest-api/reference/sender_domains/remove-a-sender-domain"},{"title":"Verify a sender domain","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/sender-domains/{domain}/verify","href":"/rest-api/reference/sender_domains/verify-a-sender-domain"}]},{"group":"settings","pages":[{"title":"Get the workspace settings","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/settings","href":"/rest-api/reference/settings/get-the-workspace-settings"},{"title":"Change workspace settings","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/settings","href":"/rest-api/reference/settings/change-workspace-settings"},{"title":"Get the Company Context","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/settings/company-context","href":"/rest-api/reference/settings/get-the-company-context"},{"title":"Get the CRM write-back settings","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/settings/crm-sync","href":"/rest-api/reference/settings/get-the-crm-write-back-settings"},{"title":"List the workspace's features","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/settings/features","href":"/rest-api/reference/settings/list-the-workspaces-features"},{"title":"Get the health settings","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/settings/health","href":"/rest-api/reference/settings/get-the-health-settings"},{"title":"List the workspace's licenses","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/settings/licenses","href":"/rest-api/reference/settings/list-the-workspaces-licenses"},{"title":"List who holds a seat","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/settings/licenses/{license_id}/users","href":"/rest-api/reference/settings/list-who-holds-a-seat"},{"title":"Get the renewal settings","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/settings/renewals","href":"/rest-api/reference/settings/get-the-renewal-settings"}]},{"group":"skills","pages":[{"title":"List skills","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/skills","href":"/rest-api/reference/skills/list-skills"},{"title":"Create a skill","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/skills","href":"/rest-api/reference/skills/create-a-skill"},{"title":"Get one skill","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/skills/{key}","href":"/rest-api/reference/skills/get-one-skill"},{"title":"Archive a skill","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/skills/{key}","href":"/rest-api/reference/skills/archive-a-skill"},{"title":"Change a skill","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/skills/{key}","href":"/rest-api/reference/skills/change-a-skill"},{"title":"Copy a skill","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/skills/{key}/clone","href":"/rest-api/reference/skills/copy-a-skill"},{"title":"Read one of a skill's files","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/skills/{key}/file","href":"/rest-api/reference/skills/read-one-of-a-skills-files"},{"title":"Make a version live","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/skills/{key}/live","href":"/rest-api/reference/skills/make-a-version-live"},{"title":"List a skill's versions","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/skills/{key}/versions","href":"/rest-api/reference/skills/list-a-skills-versions"},{"title":"Get one version of a skill","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/skills/{key}/versions/{version}","href":"/rest-api/reference/skills/get-one-version-of-a-skill"},{"title":"Read a file of one version","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/skills/{key}/versions/{version}/file","href":"/rest-api/reference/skills/read-a-file-of-one-version"}]},{"group":"surveys","pages":[{"title":"List surveys","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/surveys","href":"/rest-api/reference/surveys/list-surveys"},{"title":"Create a survey","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/surveys","href":"/rest-api/reference/surveys/create-a-survey"},{"title":"Get one survey","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/surveys/{survey_id}","href":"/rest-api/reference/surveys/get-one-survey"},{"title":"Delete a survey","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/surveys/{survey_id}","href":"/rest-api/reference/surveys/delete-a-survey"},{"title":"Change or publish a survey","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/surveys/{survey_id}","href":"/rest-api/reference/surveys/change-or-publish-a-survey"},{"title":"Duplicate a survey","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/surveys/{survey_id}/duplicate","href":"/rest-api/reference/surveys/duplicate-a-survey"},{"title":"List a survey's responses","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/surveys/{survey_id}/responses","href":"/rest-api/reference/surveys/list-a-surveys-responses"}]},{"group":"templates","pages":[{"title":"List email templates","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/templates","href":"/rest-api/reference/templates/list-email-templates"},{"title":"Create an email template","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/templates","href":"/rest-api/reference/templates/create-an-email-template"},{"title":"List merge tags","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/templates/merge-tags","href":"/rest-api/reference/templates/list-merge-tags"},{"title":"Get one email template","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/templates/{template_id}","href":"/rest-api/reference/templates/get-one-email-template"},{"title":"Delete an email template","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json delete /v1/templates/{template_id}","href":"/rest-api/reference/templates/delete-an-email-template"},{"title":"Change an email template","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json patch /v1/templates/{template_id}","href":"/rest-api/reference/templates/change-an-email-template"},{"title":"Preview an email template","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/templates/{template_id}/preview","href":"/rest-api/reference/templates/preview-an-email-template"}]},{"group":"views","pages":[{"title":"List saved views and segments","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/views","href":"/rest-api/reference/views/list-saved-views-and-segments"},{"title":"List every member's saved views and segments","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/views/all","href":"/rest-api/reference/views/list-every-members-saved-views-and-segments"},{"title":"Get one saved view or segment","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json get /v1/views/{view_id}","href":"/rest-api/reference/views/get-one-saved-view-or-segment"},{"title":"Change a view's owner","deprecated":null,"version":null,"openapi":"/api/statisfy-api.openapi.json post /v1/views/{view_id}/owner","href":"/rest-api/reference/views/change-a-views-owner"}]}]}]},{"tab":"AI Support","hidden":true,"pages":[{"title":"AI Support","href":"/ai-support/overview"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/overview"}]}]},"basePath":"","title":"Add a widget to a report - Statisfy","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BgGj2PGS.js","utils-BhNOqRKb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BAgRNUZo.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CGkb0TPw.js","snippetPresets-ChLkL1a6.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Ef10Jrbx.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DlVCnjU8.js","shallow-BA55zJxQ.js","getApiPlaygroundDisplay-DR09dKtp.js","CodeSnippet-BZ8J8Kll.js","CodeSnippets-CcguVheG.js","Page-C7x-eUfk.js","getPastedJson-D5UqeqBp.js","icon-DpD0l99C.js","MethodPill-Wg2NXsp_.js","DuplicateIcon-CCSyX8lh.js","createIcon-C4Ukv9HX.js","DynamicMarkdown-RhjEuCHC.js","SectionHeading-DL1MykRq.js","axios-vUo_bRtp.js","Markdown-BwQ4RMdp.js","dist-CiVXVcSh.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-Dic2Jtb2.js"]}