curl --request PUT \
--url https://api.usedatabrain.com/api/v2/workspace/dashboards \
--header 'Authorization: Bearer dbn_live_abc123...' \
--header 'Content-Type: application/json' \
--data '{
"workspaceName": "sales-workspace",
"dashboards": [
{
"dashboardId": "db_12345",
"filters": [
{
"name": "Region",
"applyOnTables": [
{
"dataType": "text",
"schemaName": "public",
"tableName": "orders",
"columnName": "region"
}
]
}
]
},
{
"dashboardId": "db_67890",
"filters": [
{
"name": "Created Date",
"applyOnTables": [
{
"dataType": "timestamp",
"schemaName": "analytics",
"tableName": "events",
"columnName": "created_at"
}
]
}
]
}
]
}'
{
"data": {
"success": true
},
"error": null
}
curl --request PUT \
--url https://api.usedatabrain.com/api/v2/workspace/dashboards \
--header 'Authorization: Bearer dbn_live_abc123...' \
--header 'Content-Type: application/json' \
--data '{
"workspaceName": "sales-workspace",
"dashboards": [
{
"dashboardId": "db_12345",
"filters": [
{
"name": "Region",
"applyOnTables": [
{
"dataType": "text",
"schemaName": "public",
"tableName": "orders",
"columnName": "region"
}
]
}
]
},
{
"dashboardId": "db_67890",
"filters": [
{
"name": "Created Date",
"applyOnTables": [
{
"dataType": "timestamp",
"schemaName": "analytics",
"tableName": "events",
"columnName": "created_at"
}
]
}
]
}
]
}'
{
"data": {
"success": true
},
"error": null
}
Update filter mappings for one or more dashboards inside a workspace.
curl --request PUT \
--url https://api.usedatabrain.com/api/v2/workspace/dashboards \
--header 'Authorization: Bearer dbn_live_abc123...' \
--header 'Content-Type: application/json' \
--data '{
"workspaceName": "sales-workspace",
"dashboards": [
{
"dashboardId": "db_12345",
"filters": [
{
"name": "Region",
"applyOnTables": [
{
"dataType": "text",
"schemaName": "public",
"tableName": "orders",
"columnName": "region"
}
]
}
]
},
{
"dashboardId": "db_67890",
"filters": [
{
"name": "Created Date",
"applyOnTables": [
{
"dataType": "timestamp",
"schemaName": "analytics",
"tableName": "events",
"columnName": "created_at"
}
]
}
]
}
]
}'
{
"data": {
"success": true
},
"error": null
}
curl --request PUT \
--url https://api.usedatabrain.com/api/v2/workspace/dashboards \
--header 'Authorization: Bearer dbn_live_abc123...' \
--header 'Content-Type: application/json' \
--data '{
"workspaceName": "sales-workspace",
"dashboards": [
{
"dashboardId": "db_12345",
"filters": [
{
"name": "Region",
"applyOnTables": [
{
"dataType": "text",
"schemaName": "public",
"tableName": "orders",
"columnName": "region"
}
]
}
]
},
{
"dashboardId": "db_67890",
"filters": [
{
"name": "Created Date",
"applyOnTables": [
{
"dataType": "timestamp",
"schemaName": "analytics",
"tableName": "events",
"columnName": "created_at"
}
]
}
]
}
]
}'
{
"data": {
"success": true
},
"error": null
}
Update dashboard filter-to-table mappings for dashboards that belong to a workspace.Documentation Index
Fetch the complete documentation index at: https://docs.usedatabrain.com/llms.txt
Use this file to discover all available pages before exploring further.
name against existing filter labels and updates only matched filters.dashboards, filters, applyOnTables) but can be empty. Empty arrays result in a valid no-op update.Authorization: Bearer dbn_live_abc123...
application/json.Content-Type: application/json
schemaName.tableName while preserving the provided columnName.true when all requested dashboard updates succeed.null.| Error Code | HTTP Status | Description |
|---|---|---|
INVALID_REQUEST_BODY | 400 | Missing or invalid fields in request body |
INVALID_SERVICE_TOKEN | 400 | Missing or invalid service token context |
INVALID_DASHBOARD_ID | 400 | Dashboard does not exist in the given workspace |
INTERNAL_SERVER_ERROR | 500 | Unexpected server error |
| Status Code | Description |
|---|---|
200 | OK - Dashboard filters updated successfully |
400 | Bad Request - Validation failure, invalid token context, or invalid dashboard |
500 | Internal Server Error - Unexpected server error |