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
Key | Datatype | Required | Description |
---|---|---|---|
X-Tableau-Auth | string | The 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-Type | string | ||
Accept | string |
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"}}}