How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Cisco Intersight Telemetry API

The telemetry API from Cisco Intersight — 8 operation(s) for telemetry.

Cisco Intersight Telemetry API is one of 117 APIs that Cisco Intersight publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Telemetry. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and rate-limit docs.

This API exposes 8 operations across 8 paths, and defines 119 schemas. It is described by OpenAPI 3.2.0, at version 1.0.11-20260807064027971.

Requests are made against a single base URL, https://{server}.

8 operations 8 paths 119 schemas 8 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.11-20260807064027971
Base URL
https://intersight.com
Authentication
API Key, HTTP Signature, OAuth 2.0
Resource Areas
1

Authentication & Security 3

Cisco Intersight Telemetry API declares 3 security schemes for authenticating requests. An API key is passed in the cookie as X-Starship-Token (cookieAuth). It uses HTTP signature authentication (http_signature). It supports OAuth 2.0 (oAuth2) using the authorizationCode and clientCredentials flows, exposing 3315 scopes.

  • cookieAuth — The authentication cookie obtained from a Single-Sign-On SAML assertion.
  • http_signature — The 'HTTP signature' security scheme. Each HTTP request is cryptographically signed as specified in https://datatracker.ietf.org/doc/draft-cavage-http-signatur…
  • oAuth2 — The client uses the OAuth2 security scheme. To use OAuth2, a client application must be registered by creating a iam.AppRegistration resource. The user who cre…

Paths & Operations 8

Across 8 paths, the API surfaces 8 operations — 8 POST. Each is listed below with its method, path, parameters, and response codes.

telemetry 8
POST
/api/v1/telemetry/TimeSeries
Perform a Druid TimeSeries request.
QueryTelemetryTimeSeries body → 200default
POST
/api/v1/telemetry/Topns
Perform a Druid TopN request.
QueryTelemetryTopN body → 200default
POST
/api/v1/telemetry/GroupBys
Perform a Druid GroupBy request.
QueryTelemetryGroupBy body → 200default
POST
/api/v1/telemetry/Scans
Perform a Druid Scan request.
QueryTelemetryScan body → 200default
POST
/api/v1/telemetry/Searches
Perform a Druid Search request.
QueryTelemetrySearch body → 200default
POST
/api/v1/telemetry/TimeBoundaries
Perform a Druid TimeBoundary request.
QueryTelemetryTimeBoundary body → 200default
POST
/api/v1/telemetry/SegmentMetadata
Perform a Druid SegmentMetadata request.
QueryTelemetrySegmentMetadata body → 200default
POST
/api/v1/telemetry/DataSourceMetadata
Perform a Druid DatasourceMetadata request.
QueryTelemetryDatasourceMetadata body → 200default

Schemas 119

The contract defines 119 schemas that model the data the API accepts and returns. The most detailed are telemetry.DruidQueryContext (20 properties), telemetry.DruidSegmentMetadataResult (7 properties), telemetry.DruidScanResult (3 properties), telemetry.DruidError (3 properties). Each schema is shown below with its type and property counts.

telemetry.DruidTopNMetricSpec
A Druid TopN metric spec.
telemetry.DruidLikeFilter
Like filters can be used for basic wildcard searches. They are equivalent to the SQL LIKE operator. Special characters supported are "%" (matches any number of…
telemetry.DruidJoinDataSource
Join datasources allow you to do a SQL-style join of two datasources. Stacking joins on top of each other allows you to join arbitrarily many datasources. Join…
telemetry.DruidFilteredAggregator
A filtered aggregator wraps any given aggregator, but only aggregates the values for which the given dimension filter matches. This makes it possible to comput…
telemetry.DruidHavingQueryFilter
Query filter HavingSpecs allow all Druid query filters to be used in the Having part of the query.
telemetry.DruidBaseLimitSpec
object
The limitSpec field provides the functionality to sort and limit the set of results from a groupBy query. If you group by a single dimension and are ordering b…
1 property 1 required
telemetry.DruidExtractionFunctionStringFormat
Returns the dimension value formatted according to the given format string.
telemetry.DruidQuerySpec
telemetry.DruidInFilter
The in filter can match input rows against a set of values, where a match occurs if the value is contained in the set. If an empty values array is passed to th…
telemetry.DruidSumAggregator
Computes the sum of values.
telemetry.DruidNotFilter
A logical NOT expression filter.
telemetry.DruidExtractionFunctionLowerCase
Returns the dimension values as all lower case. Optionally user can specify the language to use in order to perform lower transformation.
telemetry.DruidTopNResult
object
Sorted time series results for a particular interval based on some criteria
2 properties
telemetry.DruidExtractionFunctionStrlen
Returns the length of dimension values, as measured in the number of Unicode code units present in the string as if it were encoded in UTF-16. Note that some U…
telemetry.DruidPostAggregator
telemetry.DruidFilter
telemetry.DruidTableDataSource
The table data source is the most common datasource type. They are split up into segments, distributed around the cluster, and queried in parallel.
telemetry.DruidBaseSearchSpec
object
The base structure for all Druid search specifications.
1 property 1 required
telemetry.DruidRegexSearchSpec
The specification for a Druid 'insensitivecontains' search
telemetry.DruidBaseAggregator
object
A Druid aggregator.
1 property 1 required
telemetry.DruidBaseHavingFilter
object
A having clause is a JSON object identifying which rows from a groupBy query should be returned, by specifying conditions on aggregated values. It is essential…
1 property 1 required
telemetry.DruidFalseFilter
A filter matches no values. You can use it to force a query to match no values.
telemetry.DruidAggregateSearchSpec
Generic search specification descriptor
telemetry.DruidExtractionFunctionTimeFormat
Returns the dimension value formatted according to the given format string, time zone, and locale. For time dimension values, this formats the time value bucke…
telemetry.DruidBaseDimensionSpec
object
A dimension spec is used in a query to operate on dimension values.
1 property 1 required
telemetry.DruidTrueFilter
A filter which matches all values. You can use it to temporarily disable other filters without removing them.
telemetry.DruidQuerySpecInsensitiveContains
A 'insensitivecontains' query spec. Note that an "insensitivecontains" search is equivalent to a "contains" search with "caseSensitive" false (or not provided).
telemetry.DruidExpressionFilter
The expression filter allows for the implementation of arbitrary conditions, leveraging the Druid expression system. This filter allows for complete flexibilit…
telemetry.DruidQuerySpecContains
A 'contains' query spec.
telemetry.DruidCountAggregator
Computes the count of Druid rows that match the filters. The count aggregator counts the number of Druid rows, which does not always reflect the number of raw…
telemetry.DruidExtractionFunctionRegex
Returns the first matching group for the given regular expression. If there is no match, it returns the dimension value as is.
telemetry.DruidAggregator
telemetry.DruidSearchFilter
You can use search filters to filter on partial string matches.
telemetry.DruidHyperUniquePostAggregator
The hyperUniqueCardinality post aggregator is used to wrap a hyperUnique object such that it can be used in post aggregations. This post-aggregator will inheri…
telemetry.DruidBaseVirtualColumn
object
Virtual columns are columns that are computed on the fly during query execution. If you include a virtual column as part of a query, make sure to include all a…
1 property 1 required
telemetry.DruidScanResult
object
Druid Scan row result.
3 properties
telemetry.NestedFieldVirtualColumn
A virtual column defined as a nested field. The nested field virtual column is an optimized virtual column that can provide direct access into various paths of…
telemetry.DruidTimeSeriesRequest
These types of queries take a timeseries query object and return an array of JSON objects where each object represents a value asked for by the timeseries quer…
telemetry.DruidExtractionFunction
The extraction function is used to transform input values before the filter is applied. Transformations can be applied to both regular (string) dimensions, as…
telemetry.DruidListFilteredVirtualColumn
This virtual column provides an alternative way to use 'list filtered' dimension spec as a virtual column. It has optimized access to the underlying column val…
telemetry.DruidSearchResult
object
Dimension value matching the search query.
2 properties
telemetry.DruidConstantPostAggregator
The constant post-aggregator always returns the specified value.
telemetry.DruidThetaSketchOperationsPostAggregator
telemetry.DruidColumnComparisonFilter
The column comparison filter compares dimensions to each other.
telemetry.DruidDimensionSpec
telemetry.DruidFirstLastAggregator
(Double/Float/Long) First and Last aggregator cannot be used in ingestion spec, and should only be specified as part of queries. Note that queries with first/l…
telemetry.DruidNullFilter
The null filter is a partial replacement for the selector filter. It is dedicated to matching NULL values.
telemetry.DruidQuerySpecFragment
A 'fragment' query spec.
telemetry.DruidGranularity
The granularity field determines how data gets bucketed across the time dimension, or how it gets aggregated by hour, day, minute, etc. It can be specified eit…
telemetry.DruidQueryContext
object
The query context is used for various query configuration parameters. Can be used to modify query behavior, including grand totals and zero-filling.
20 properties
telemetry.DruidGroupByRequest
These types of Apache Druid queries take a groupBy query object and return an array of JSON objects where each object represents a grouping asked for by the qu…
telemetry.DruidAnyAggregator
Returns any value including null. This aggregator can simplify and optimize the performance by returning the first encountered value (including null).
telemetry.DruidDataSource
A data source is the Apache Druid equivalent of a database table. However, a query can also masquerade as a data source, providing subquery-like functionality.…
telemetry.DruidBaseGranularity
object
The base structure for a Druid granularity.
1 property 1 required
telemetry.DruidExtractionFunctionCascade
Provides chained execution of extraction functions. A property of extractionFns contains an array of any extraction functions, which is executed in the array i…
telemetry.DruidUnionDataSource
This data source unions two or more table data sources. Note that the data sources being unioned should have the same schema.
telemetry.DruidTopNRequest
TopN queries return a sorted set of results for the values in a given dimension according to some criteria. Conceptually, they can be thought of as an approxim…
telemetry.DruidExtractionFunctionUpperCase
Returns the dimension values as all upper case. Optionally user can specify the language to use in order to perform upper transformation.
telemetry.DruidTimeBoundaryRequest
Time boundary queries return the earliest and latest data points of a data set.
telemetry.DruidInsensitiveContainsSearchSpec
The specification for a Druid 'insensitivecontains' search
telemetry.DruidError
object
The error response when a Druid query fails.
3 properties
telemetry.DruidIntervalFilter
The Interval filter enables range filtering on columns that contain long millisecond values, with the boundaries specified as ISO 8601 time intervals. It is su…
telemetry.DruidThetaSketchEstimatePostAggregator
Post aggregator of type fieldAccess that refers to a thetaSketch aggregator or that of type thetaSketchSetOp.
telemetry.DruidQueryDataSource
This is used for nested groupBys and is only currently supported for groupBys.
telemetry.DruidExtractionDimensionSpec
Returns dimension values transformed using the given extraction function.
telemetry.DruidExtractionFunctionSubstring
Returns a substring of the dimension value starting from the supplied index and of the desired length. Both index and length are measured in the number of Unic…
telemetry.DruidMinMaxAggregator
Computes the min or max of values.
telemetry.DruidHavingDimensionSelectorFilter
The dimSelector filter will match rows with dimension values equal to the specified value.
telemetry.DruidDataSourceMetadataResult
object
Metadata about a Druid datasource
2 properties
telemetry.DruidFragmentSearchSpec
The specification for a Druid 'insensitivecontains' search
telemetry.DruidScanRequest
The Scan query returns raw Apache Druid rows in streaming mode. In addition to straightforward usage where a Scan query is issued to the Broker, the Scan query…
telemetry.DruidBoundFilter
Bound filters can be used to filter on ranges of dimension values. It can be used for comparison filtering like greater than, less than, greater than or equal…
telemetry.DruidBaseDataSource
object
A data source is the Apache Druid equivalent of a database table. However, a query can also masquerade as a data source, providing subquery-like functionality.…
1 property 1 required
telemetry.DruidDefaultDimensionSpec
Returns dimension values as is and optionally renames the dimension.
telemetry.DruidDurationGranularity
Duration granularities are specified as an exact duration in milliseconds and timestamps are returned as UTC. Duration granularity values are in milliseconds.…
telemetry.DruidBaseQuerySpec
object
A Druid query spec.
1 property 1 required
telemetry.DruidFieldAccessorPostAggregator
These post-aggregators return the value produced by the specified aggregator. 'fieldName' refers to the output name of the aggregator given in the aggregations…
telemetry.DruidInlineDataSource
Inline datasources allow you to query a small amount of data that is embedded in the query itself. They are useful when you want to write a query on a small am…
telemetry.DruidContainsSearchSpec
The specification for a Druid 'insensitivecontains' search
telemetry.DruidPeriodGranularity
Period granularities are specified as arbitrary period combinations of years, months, weeks, hours, minutes and seconds (e.g., P2W, P3M, PT1H30M, PT0.750S) in…
telemetry.DruidExtractionFunctionTimeParsing
Parses dimension values as timestamps using the given input format, and returns them formatted using the given output format. Note, if you are working with the…
telemetry.DruidTimeBoundaryResult
object
The earliest and latest timestamps for a dataset
2 properties
telemetry.DruidEqualityFilter
The equality filter is a replacement for the selector filter with the ability to match against any type of column. The equality filter is designed to have more…
telemetry.DruidHavingFilter
telemetry.DruidAndFilter
A logical AND expression filter.
telemetry.DruidStringAnyAggregator
Returns any value including null. This aggregator can simplify and optimize the performance by returning the first encountered value (including null).
telemetry.DruidStringFirstLastAggregator
Computes the metric value with the minimum/maximum timestamp or null if no row exist.
telemetry.DruidDataSourceMetadataRequest
Data Source Metadata queries return metadata information for a dataSource. These queries return information about the timestamp of latest ingested event for th…
telemetry.DruidDimensionTopNMetricSpec
This metric specification sorts TopN results by dimension value, using one of the sorting orders.
telemetry.DruidExtractionFunctionSearchQuery
Returns the dimension value unchanged if the given SearchQuerySpec matches, otherwise returns null.
telemetry.DruidOrFilter
A logical OR expression filter.
telemetry.DruidDefaultLimitSpec
The default limit spec takes a limit and the list of columns to do an orderBy operation over.
telemetry.DruidGreatestLeastPostAggregator
doubleGreatest and longGreatest computes the maximum of all fields and Double.NEGATIVEINFINITY. doubleLeast and longLeast computes the minimum of all fields an…
telemetry.DruidArithmeticPostAggregator
The arithmetic post-aggregator applies the provided function to the given fields from left to right. The fields can be aggregators or other post aggregators. S…
telemetry.DruidGroupByResult
object
A time series result based on a provided groupBy query. Result can contain multiple dimensions and values.
3 properties
telemetry.DruidRegexFilter
The regular expression filter is similar to the selector filter, but using regular expressions. It matches the specified dimension with the given pattern. Note…
telemetry.DruidExpressionPostAggregator
A post-aggregator defined as a Druid expression. Supported Druid expressions are documented at https://druid.apache.org/docs/latest/misc/math-expr.html.
telemetry.DruidExpressionVirtualColumn
A virtual column defined as a Druid expression. Supported Druid expressions are documented at https://druid.apache.org/docs/latest/misc/math-expr.html.
telemetry.DruidRangeFilter
The range filter is a replacement for the bound filter. It compares against any type of column and is designed to have has more SQL compliant behavior than the…
telemetry.DruidBaseExtractionFunction
object
Extraction functions define the transformation applied to each dimension value. Transformations can be applied to both regular (string) dimensions, as well as…
1 property 1 required
telemetry.DruidExtractionFunctionInlineLookup
Lookups are a concept in Druid where dimension values are (optionally) replaced with new values. The "lookup" extraction function lets you specify an inline lo…
telemetry.DruidExtractionFunctionBucket
Bucket extraction function is used to bucket numerical values in each range of the given size by converting them to the same base value. Non numeric values are…
telemetry.DruidThetaSketchAggregator
Theta sketch aggregation provides a class of specialized algorithms, called streaming algorithms, or sketches that can produce results orders-of magnitude fast…
telemetry.DruidSegmentMetadataRequest
Time boundary queries return the earliest and latest data points of a data set.
telemetry.DruidSelectorFilter
The selector filter matches a specific dimension with a specific value. Selector filters can be used as the base filters for more complex Boolean expressions o…
telemetry.DruidSearchRequest
These types of queries returns dimension values that match the search specification
telemetry.DruidBaseFilter
object
A filter is a JSON object indicating which rows of data should be included in the computation for a query. It's essentially the equivalent of the WHERE clause…
1 property 1 required
telemetry.DruidBaseRequest
object
The base structure for all Druid requests.
1 property 1 required
telemetry.DruidBasePostAggregator
object
Post-aggregations are specifications of processing that should happen on aggregated values as they come out of Apache Druid. If you include a post aggregation…
2 properties 1 required
telemetry.DruidIntervalResult
object
The time series results for a particular interval
2 properties
telemetry.DruidHavingNumericFilter
The simplest having clause is a numeric filter. Numeric filters can be used as the base filters for more complex boolean expressions of filters.
telemetry.DruidExtractionFunctionPartial
Returns the dimension value unchanged if the regular expression matches, otherwise returns null.
telemetry.DruidSegmentMetadataResult
object
Metadata about a Druid segment
7 properties
telemetry.DruidOrderByColumnSpec
object
OrderByColumnSpecs indicate how to do order by operations. Each order-by condition can be a jsonString or a map.
3 properties
telemetry.DruidInvertedTopNMetricSpec
Sort dimension values in inverted order, i.e inverts the order of the delegate metric spec. It can be used to sort the values in ascending order.
telemetry.DruidBaseTopNMetricSpec
object
A Druid TopN metric spec.
1 property 1 required
telemetry.DruidNumericTopNMetricSpec
The simplest metric specification is a String value indicating the metric to sort topN results by.
telemetry.DruidVirtualColumn
telemetry.DruidLookupDataSource
Lookup datasources correspond to Druid's key-value lookup objects. In Druid SQL, they reside in the the lookup schema. They are preloaded in memory on all serv…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

intersight-telemetry-api-openapi.yml Raw ↑

Other APIs Cisco Intersight publishes across the network.

Cisco Intersight Aaa API
Cisco Intersight Access API
Cisco Intersight Adapter API
Cisco Intersight Apiproxy API
Cisco Intersight Appliance API
Cisco Intersight Asset API
Cisco Intersight Auditd API
Cisco Intersight Bios API
Cisco Intersight Boot API
Cisco Intersight Bulk API
Cisco Intersight Capability API
Cisco Intersight Catalystsdwan API
Where this information came from

This is an independent, third-party profile of Cisco Intersight Telemetry API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.