List dashboards — GET /v1/o11y/users/me/dashboards
Dashboard list V2 personalized for the calling user: each dashboard carries the caller's pinned state, and pinned dashboards float to the top of the requested ordering.
GET /v1/o11y/users/me/dashboards
| Address | https://api.hanzo.ai/v1/o11y/users/me/dashboards |
| Method | GET |
| Operation | ListDashboardsForUserV2 |
| Auth | Authorization: Bearer $HANZO_API_KEY |
Dashboard list V2 personalized for the calling user: each dashboard carries the caller's pinned state, and pinned dashboards float to the top of the requested ordering. Supports the same filter DSL, sort, order and pagination.
Callers need the viewer role; the runtime's own gate enforces it.
Request
5 fields.
| Field | In | Type | Required | Description |
|---|---|---|---|---|
query | query | string | — | Query is the filter DSL over dashboard columns and tags, e.g. name:cpu source:user. |
sort | query | string | — | Sort is the sort field: updated_at, created_at or name. |
order | query | string | — | Order is the sort direction: asc or desc. |
limit | query | integer | — | Limit caps how many dashboards come back. |
offset | query | integer | — | Offset is how many dashboards to skip for pagination. |
Response
| Status | Body | Meaning |
|---|---|---|
200 | o11y.O11yDashboardListForUserOut | ok |
202 | Approval | held for approval |
default | problem-details | refused |
200 body — 26 fields.
| Field | In | Type | Always | Description |
|---|---|---|---|---|
data | body | o11y.O11yDashboardListForUser | — | |
data.dashboards | body | o11y.O11yDashboardListItemForUser[] | — | Dashboards are the rows for this page, each with the caller's pin state. |
data.dashboards[].createdAt | body | string (date-time) | — | |
data.dashboards[].createdBy | body | string | — | |
data.dashboards[].id | body | string | — | |
data.dashboards[].image | body | string | — | |
data.dashboards[].locked | body | boolean | — | |
data.dashboards[].name | body | string | — | |
data.dashboards[].orgId | body | string | — | |
data.dashboards[].pinned | body | boolean | — | Pinned reports whether the calling user has pinned this dashboard. |
data.dashboards[].schemaVersion | body | string | — | |
data.dashboards[].source | body | string | — | |
data.dashboards[].spec | body | o11y.O11yDashboardListSpec | — | |
data.dashboards[].spec.display | body | o11y.O11yDashboardDisplay | — | |
data.dashboards[].spec.display.description | body | string | — | Description says what the dashboard is for. |
data.dashboards[].spec.display.name | body | string | — | Name is the human-facing dashboard name. |
data.dashboards[].tags | body | o11y.O11yDashboardTag[] | — | |
data.dashboards[].tags[].key | body | string | — | Key is the tag key. |
data.dashboards[].tags[].value | body | string | — | Value is the tag value. |
data.dashboards[].updatedAt | body | string (date-time) | — | |
data.dashboards[].updatedBy | body | string | — | |
data.tags | body | o11y.O11yDashboardTag[] | — | Tags are all tags in use across the org's dashboards. |
data.tags[].key | body | string | — | Key is the tag key. |
data.tags[].value | body | string | — | Value is the tag value. |
data.total | body | integer (int64) | — | Total is the count across all pages. |
status | body | string | — | Status is "success". |
Failure carries the platform error shape — see Errors.
Examples
CLI
SDK
HTTP
MCP
hanzo o11y users me dashboards list.ts
.py
.go
.rs
.java
import { Configuration, O11yApi } from 'hanzoai';
const api = new O11yApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.listDashboardsForUserV2();from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import O11yApi
client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = O11yApi(client).list_dashboards_for_user_v2()cfg := hanzoai.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := hanzoai.NewAPIClient(cfg)
resp, _, err := client.O11yAPI.ListDashboardsForUserV2(context.Background()).Execute()
if err != nil {
return err
}use hanzo_client::apis::{configuration::Configuration, o11y_api};
let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();
let result = o11y_api::list_dashboards_for_user_v2(&cfg, Default::default()).await?;import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.O11yApi;
ApiClient client = new ApiClient();
client.setBearerToken(System.getenv("HANZO_API_KEY"));
var result = new O11yApi(client).listDashboardsForUserV2();curl https://api.hanzo.ai/v1/o11y/users/me/dashboards \
-H "Authorization: Bearer $HANZO_API_KEY"Tool o11y, op ListDashboardsForUserV2 — POST the JSON-RPC envelope to https://api.hanzo.ai/v1/mcp.
curl -X POST https://api.hanzo.ai/v1/mcp \
-H "Authorization: Bearer $HANZO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "o11y",
"arguments": {
"op": "ListDashboardsForUserV2",
"input": {}
}
}
}'Was this page useful?