Search for dashboards
Returns a paginated list of dashboards. This operation is similar to Get dashboards except that the results can be refined to include dashboards that have specific attributes. For example, dashboards with a particular name. When multiple attributes are specified only filters matching all attributes are returned.
This operation can be accessed anonymously.
Permissions required: The following dashboards that match the query parameters are returned:
- Dashboards owned by the user. Not returned for anonymous users.
- Dashboards shared with a group that the user is a member of. Not returned for anonymous users.
- Dashboards shared with a private project that the user can browse. Not returned for anonymous users.
- Dashboards shared with a public project.
- Dashboards shared with the public.
Query parameters
String used to perform a case-insensitive partial match with name.
User account ID used to return dashboards with the matching owner.accountId. This parameter cannot be used with the owner parameter.
This parameter is deprecated because of privacy changes. Use accountId instead. See the migration guide for details. User name used to return dashboards with the matching owner.name. This parameter cannot be used with the accountId parameter.
As a group's name can change, use of groupId is recommended. Group name used to return dashboards that are shared with a group that matches sharePermissions.group.name. This parameter cannot be used with the groupId parameter.
Group ID used to return dashboards that are shared with a group that matches sharePermissions.group.groupId. This parameter cannot be used with the groupname parameter.
Project ID used to returns dashboards that are shared with a project that matches sharePermissions.project.id.
Order the results by a field:
- description Sorts by dashboard description. Note that this sort works independently of whether the expand to display the description field is in use.
- favourite_count Sorts by dashboard popularity.
- id Sorts by dashboard ID.
- is_favourite Sorts by whether the dashboard is marked as a favorite.
- name Sorts by dashboard name.
- owner Sorts by dashboard owner name.
The index of the first item to return in a page of results (page offset).
The maximum number of items to return per page.
The status to filter by. It may be active, archived or deleted.
Use expand to include additional information about dashboard in the response. This parameter accepts a comma-separated list. Expand options include:
- description Returns the description of the dashboard.
- owner Returns the owner of the dashboard.
- viewUrl Returns the URL that is used to view the dashboard.
- favourite Returns isFavourite, an indicator of whether the user has set the dashboard as a favorite.
- favouritedCount Returns popularity, a count of how many users have set this dashboard as a favorite.
- sharePermissions Returns details of the share permissions defined for the dashboard.
- editPermissions Returns details of the edit permissions defined for the dashboard.
- isWritable Returns whether the current user has permission to edit the dashboard.
Response
Returned if the request is successful.