Get views

Returns one saved explorer view by id.

GET /v1/o11y/explorer/views/{viewId}

Addresshttps://api.hanzo.ai/v1/o11y/explorer/views/{viewId}
MethodGET
Operationget_o11y_explorer_views_by_viewid
AuthAuthorization: Bearer $HANZO_API_KEY

Returns one saved explorer view by id.

Callers need the viewer role; the runtime's own gate enforces it.

Request

1 field.

FieldInTypeRequiredDescription
viewIdpathstringyesViewID is the view's id.

Response

StatusBodyMeaning
200o11y.O11ySavedViewOutok
202Approvalheld for approval
defaultproblem-detailsrefused

200 body — 92 fields.

FieldInTypeAlwaysDescription
databodyo11y.SavedView—
data.categorybodystring—
data.compositeQuerybodyo11y.v3.CompositeQuery—
data.compositeQuery.builderQueriesbodyobject—
data.compositeQuery.builderQueries.*bodyo11y.BuilderQuery—
data.compositeQuery.builderQueries.*.IsAnomalybodyboolean—
data.compositeQuery.builderQueries.*.QueriesUsedInFormulabodystring[]—
data.compositeQuery.builderQueries.*.ShiftBybodyinteger (int64)—
data.compositeQuery.builderQueries.*.aggregateAttributebodyo11y.AttributeKey—
data.compositeQuery.builderQueries.*.aggregateAttribute.dataTypebodystring—
data.compositeQuery.builderQueries.*.aggregateAttribute.isColumnbodyboolean—
data.compositeQuery.builderQueries.*.aggregateAttribute.isJSONbodyboolean—
data.compositeQuery.builderQueries.*.aggregateAttribute.keybodystring—
data.compositeQuery.builderQueries.*.aggregateAttribute.typebodystring—
data.compositeQuery.builderQueries.*.aggregateOperatorbodystring—
data.compositeQuery.builderQueries.*.dataSourcebodystring—
data.compositeQuery.builderQueries.*.disabledbodyboolean—
data.compositeQuery.builderQueries.*.expressionbodystring—
data.compositeQuery.builderQueries.*.filtersbodyo11y.FilterSet—
data.compositeQuery.builderQueries.*.filters.itemsbodyo11y.FilterItem[]—
data.compositeQuery.builderQueries.*.filters.items[].keybodyo11y.AttributeKey—
data.compositeQuery.builderQueries.*.filters.items[].key.dataTypebodystring—
data.compositeQuery.builderQueries.*.filters.items[].key.isColumnbodyboolean—
data.compositeQuery.builderQueries.*.filters.items[].key.isJSONbodyboolean—
data.compositeQuery.builderQueries.*.filters.items[].key.keybodystring—
data.compositeQuery.builderQueries.*.filters.items[].key.typebodystring—
data.compositeQuery.builderQueries.*.filters.items[].opbodystring—
data.compositeQuery.builderQueries.*.filters.items[].valuebodyany—
data.compositeQuery.builderQueries.*.filters.opbodystring—
data.compositeQuery.builderQueries.*.functionsbodyo11y.Function[]—
data.compositeQuery.builderQueries.*.functions[].argsbodyany[]—
data.compositeQuery.builderQueries.*.functions[].namebodystring—
data.compositeQuery.builderQueries.*.functions[].namedArgsbodyobject—
data.compositeQuery.builderQueries.*.functions[].namedArgs.*bodyany—
data.compositeQuery.builderQueries.*.groupBybodyo11y.AttributeKey[]—
data.compositeQuery.builderQueries.*.groupBy[].dataTypebodystring—
data.compositeQuery.builderQueries.*.groupBy[].isColumnbodyboolean—
data.compositeQuery.builderQueries.*.groupBy[].isJSONbodyboolean—
data.compositeQuery.builderQueries.*.groupBy[].keybodystring—
data.compositeQuery.builderQueries.*.groupBy[].typebodystring—
data.compositeQuery.builderQueries.*.havingbodyo11y.Having[]—
data.compositeQuery.builderQueries.*.having[].columnNamebodystring—
data.compositeQuery.builderQueries.*.having[].opbodystring—
data.compositeQuery.builderQueries.*.having[].valuebodyany—
data.compositeQuery.builderQueries.*.legendbodystring—
data.compositeQuery.builderQueries.*.limitbodyinteger (uint64)—
data.compositeQuery.builderQueries.*.offsetbodyinteger (uint64)—
data.compositeQuery.builderQueries.*.orderBybodyo11y.OrderBy[]—
data.compositeQuery.builderQueries.*.orderBy[].columnNamebodystring—
data.compositeQuery.builderQueries.*.orderBy[].orderbodystring—
data.compositeQuery.builderQueries.*.pageSizebodyinteger (uint64)—
data.compositeQuery.builderQueries.*.queryNamebodystring—
data.compositeQuery.builderQueries.*.reduceTobodystring—
data.compositeQuery.builderQueries.*.selectColumnsbodyo11y.AttributeKey[]—
data.compositeQuery.builderQueries.*.selectColumns[].dataTypebodystring—
data.compositeQuery.builderQueries.*.selectColumns[].isColumnbodyboolean—
data.compositeQuery.builderQueries.*.selectColumns[].isJSONbodyboolean—
data.compositeQuery.builderQueries.*.selectColumns[].keybodystring—
data.compositeQuery.builderQueries.*.selectColumns[].typebodystring—
data.compositeQuery.builderQueries.*.seriesAggregationbodystring—
data.compositeQuery.builderQueries.*.spaceAggregationbodystring—
data.compositeQuery.builderQueries.*.stepIntervalbodyinteger (int64)—
data.compositeQuery.builderQueries.*.temporalitybodystring—
data.compositeQuery.builderQueries.*.timeAggregationbodystring—
data.compositeQuery.chQueriesbodyobject—
data.compositeQuery.chQueries.*bodyo11y.DatastoreQuery—
data.compositeQuery.chQueries.*.disabledbodyboolean—
data.compositeQuery.chQueries.*.legendbodystring—
data.compositeQuery.chQueries.*.querybodystring—
data.compositeQuery.fillGapsbodyboolean—FillGaps is used to fill the gaps in the time series data
data.compositeQuery.panelTypebodystring—
data.compositeQuery.promQueriesbodyobject—
data.compositeQuery.promQueries.*bodyo11y.PromQuery—
data.compositeQuery.promQueries.*.disabledbodyboolean—
data.compositeQuery.promQueries.*.legendbodystring—
data.compositeQuery.promQueries.*.querybodystring—
data.compositeQuery.promQueries.*.statsbodystring—
data.compositeQuery.queriesbodyo11y.QueryEnvelope[]—
data.compositeQuery.queries[].specbodyany—Spec is the deferred decoding of the query if any.
data.compositeQuery.queries[].typebodyany—Type is the type of the query.
data.compositeQuery.queryTypebodystring—
data.compositeQuery.unitbodystring—Unit for the time series data shown in the graph This is used in alerts to format the value and threshold
data.createdAtbodystring (date-time)—
data.createdBybodystring—
data.extraDatabodystring—ExtraData is JSON encoded data used by frontend to store additional data
data.idbodyany—
data.namebodystring—
data.sourcePagebodystring—
data.tagsbodystring[]—
data.updatedAtbodystring (date-time)—
data.updatedBybodystring—
statusbodystring—Status is "success".

Failure carries the platform error shape — see Errors.

Examples

hanzo o11y explorer views get <viewId>
import { Configuration, O11yApi } from 'hanzoai';

const api = new O11yApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.getO11yExplorerViewsByViewid({ viewId: 'viewId' });
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).get_o11y_explorer_views_by_viewid(view_id='viewId')
cfg := hanzoai.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := hanzoai.NewAPIClient(cfg)

resp, _, err := client.O11yAPI.GetO11yExplorerViewsByViewid(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::get_o11y_explorer_views_by_viewid(&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).getO11yExplorerViewsByViewid();
curl https://api.hanzo.ai/v1/o11y/explorer/views/<viewId> \
  -H "Authorization: Bearer $HANZO_API_KEY"

MCP reaches o11y through the o11y tool, which names its 307 operations with its own verbs — this one among them, under a name only MCP declares. describe explains any of them:

curl -X POST https://api.hanzo.ai/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/call",
       "params": {
         "name": "describe",
         "arguments": {
           "op": "list_o11y_autocomplete_aggregate_attributes"
         }
       }
     }'

O11y API · All Hanzo APIs · Interactive reference

Was this page useful?