Skip to main content
PUT
Update dashboard filter-to-table mappings for dashboards that belong to a workspace.
First-time workspace dashboard integration: If you are wiring this flow for the first time, complete provisioning before calling this endpoint:
  1. Create an embed: Set up embedding with Create Embed or Create Dashboard Embed.
  2. List embeds: Use List Embeds to verify metadata configurations and identify the created embed.
  3. Update: Call Update Workspace Dashboards to apply filter mapping changes using the embed id listed in metadata.
Skipping these steps often leads to unknown dashboard IDs or filter names that do not match anything on the dashboard, in which case updates are ignored or fail validation.
This endpoint updates existing dashboard filters by filter name. For each dashboard, DataBrain matches each input filter name against existing filter labels and updates only matched filters.
Array fields are required by schema (dashboards, filters, applyOnTables) but can be empty. Empty arrays result in a valid no-op update.

Authentication

This endpoint requires a service token in the Authorization header. To access your service token:
  1. In Settings page, navigate to the Service Tokens section.
  2. Click Generate Token to create a service token if you do not have one.

Headers

string
required
Bearer token for API authentication. Use your service token.
string
required
Must be set to application/json.

Request Body

string
required
Name of the workspace containing the dashboards to update.
array
required
List of dashboard filter update payloads.
string
required
External dashboard ID to update.
array
required
List of filters to update for this dashboard.
string
required
Filter name to match against the existing dashboard filter label.
array
required
List of table/column targets where this filter should apply.
'string' | 'number' | 'date'
required
Datatype of the target column. Must be one of: string, number, or date.
string
required
Schema name of the target table.
string
required
Table name without schema.
string
required
Target column name.
Internally, DataBrain stores table references as schemaName.tableName while preserving the provided columnName.
If a provided filter name does not match any existing dashboard filter label, that filter is ignored and existing filter configuration remains unchanged.

Response

object
Success payload.
boolean
Returns true when all requested dashboard updates succeed.
null | object
Error object if the request fails, otherwise null.

Examples

Possible Errors

HTTP Status Code Summary

Next Steps

List Workspaces

Verify workspace names before update calls

Fetch Metrics by Workspace

Validate downstream metric behavior after dashboard filter updates