Create Dashboard Filter

Version 4.0.24.6 (latest)

Create a dashboard filter on the dashboard with a specific id.

Request

POST /dashboard_filters
Datatype
Description
Request
HTTP Request
body
HTTP Body
Expand HTTP Body definition...
body
Dashboard Filter
Expand CreateDashboardFilter definition...
id
string
Unique Id
dashboard_id
string
Id of Dashboard
name
string
Name of filter
title
string
Title of filter
type
string
Type of filter: one of date, number, string, or field
default_value
string
Default value of filter
model
string
Model of filter (required if type = field)
explore
string
Explore of filter (required if type = field)
dimension
string
Dimension of filter (required if type = field)
field
object
Field information
row
integer
Display order of this filter relative to other filters
listens_to_filters
string[]
allow_multiple_values
boolean
Whether the filter allows multiple filter values (deprecated in the latest version of dashboards)
required
boolean
Whether the filter requires a value to run the dashboard
ui_config
object
The visual configuration for this filter. Used to set up how the UI for this filter should appear.
query
HTTP Query
Expand HTTP Query definition...
fields
string
Requested fields

Response

200: Dashboard Filter

Datatype
Description
(object)
can
object
Operations the current user is able to perform on this object
id
string
Unique Id
dashboard_id
string
Id of Dashboard
name
string
Name of filter
title
string
Title of filter
type
string
Type of filter: one of date, number, string, or field
default_value
string
Default value of filter
model
string
Model of filter (required if type = field)
explore
string
Explore of filter (required if type = field)
dimension
string
Dimension of filter (required if type = field)
field
object
Field information
row
integer
Display order of this filter relative to other filters
listens_to_filters
string[]
allow_multiple_values
boolean
Whether the filter allows multiple filter values (deprecated in the latest version of dashboards)
required
boolean
Whether the filter requires a value to run the dashboard
ui_config
object
The visual configuration for this filter. Used to set up how the UI for this filter should appear.

400: Bad Request

Datatype
Description
(object)
message
string
Error details
documentation_url
string
Documentation link

404: Not Found

Datatype
Description
(object)
message
string
Error details
documentation_url
string
Documentation link

409: Resource Already Exists

Datatype
Description
(object)
message
string
Error details
documentation_url
string
Documentation link

422: Validation Error

Datatype
Description
(object)
message
string
Error details
Expand ValidationErrorDetail definition...
field
string
Field with error
code
string
Error code
message
string
Error info message
documentation_url
string
Documentation link
documentation_url
string
Documentation link

429: Too Many Requests

Datatype
Description
(object)
message
string
Error details
documentation_url
string
Documentation link

Examples