Generate current metric value insight bundle

POST {{baseUrl}}/api/-/pulse/insights/ban

Generates a bundle the current aggregated value for each metric.

Version: Available in API 3.21 (Tableau Cloud December 2023) and later. Not available for Tableau Server. Versioning Overview

Permissions: Any user can create a metric in a definition as long as the user has read or connect access to the data source used in the definition. Permissions Overview

License: No additional license required.

Access Scope: tableau:insights:read
Access Scopes Overview: Cloud

HEADERS

KeyDatatypeRequiredDescription
X-Tableau-AuthstringThe Tableau authentication header. The value is a credentials token from a Tableau server's response to an authentication request.
The Content-Type and Accept headers should be the mediatype of the request and response except in cases where you want to explicitly allow other versions of the resource.
Content-Typestring
Acceptstring

RESPONSES

status: Created

{"bundle_response":{"result":{"insight_groups":[{"type":"ban","insights":[{"result":{"type":"popc","version":1,"content":"","markup":"There was an  increase of +2 (+33.3%) over December 28, 2023.","viz":{},"facts":{"target_period_value":{"raw":8,"formatted":"8"},"comparison_period_value":{"raw":6,"formatted":"6"},"target_time_period":{"range":"Dec 29, 2023","label":"Dec 29","granularity":"day","start_timestamp":"2023-12-29T00:00:00Z","end_timestamp":"2023-12-30T00:00:00Z"},"comparison_time_period":{"end_timestamp":"2023-12-29T00:00:00Z","range":"Dec 28, 2023","label":"Dec 28","granularity":"day","start_timestamp":"2023-12-28T00:00:00Z"},"difference":{"relative":{"formatted":"33.3%","raw":0.3333333333333333},"direction":"up","absolute":{"raw":2,"formatted":"2"}},"sentiment":"neutral"},"characterization":"CHARACTERIZATION_UNSPECIFIED","question":"How has Maintenance Hours changed?","score":0,"id":"c864234a-9b21-43d0-a538-22d23c149a11","insight_feedback_metadata":{"type":"popc","score":0,"dimension_hash":""}},"insight_type":"popc"}],"summaries":[]}],"has_errors":false,"characterization":"CHARACTERIZATION_UNSPECIFIED"}}}