List tags

Returns a paginated list of tags (both correlation and metric kinds)
defined across the tenant's datasets. Each entry groups all per-dataset
definitions of a single (name, kind) pair.

Use GET /v1/tags/values to search tag values.

Filtering and ordering with CEL

The filter and orderBy query parameters are evaluated as
Common Expression Language (CEL) expressions over
each tag in the response.

Available CEL fields

  • name (string) — tag name; supports .matches("regex")
  • kind (string) — "Correlation" or "Metric"
  • datasetCount (int) — number of distinct datasets defining the tag
  • mappings (list) — per-dataset definitions; supports .exists(m, ...)
    quantifier. Each m exposes:
    • m.dataset.id (int) — dataset id
    • m.dataset.label (string) — dataset label (available without
      expand); matches the dataset.record.label returned in the body
    • m.path.field (string)
    • m.path.path (string)
    • m.origin.id (int, null for Metric) — dataset where the mapping
      was originally declared. Equals m.dataset.id when declared
      directly on that dataset; differs when inherited from upstream.
    • m.origin.label (string, null for Metric) — label of the origin
      dataset; guard with m.origin != null before accessing.
    • m.createdBy.id (int, null for Metric)

Available CEL functions

The tag CEL environment registers the CEL standard
definitions

(operators, in, ?:, size(), string.contains, string.startsWith,
string.endsWith, matches, etc.) plus the following extension
libraries from
cel-go v0.28.0:

  • ext.StringscharAt, indexOf, join, lowerAscii, replace, split, substring, trim, upperAscii, format
  • ext.Listslists.flatten, lists.range, lists.slice
  • ext.Mathmath.greatest, math.least
  • ext.Setssets.contains, sets.equivalent, sets.intersects
  • ext.Regexre.capture, re.extract
  • ext.Encodersbase64.encode, base64.decode
  • ext.Bindingscel.bind for let-binding sub-expressions
  • ext.Protos — protobuf helpers
  • cel.OptionalTypesoptional.of, optional.ofNonZero, optional.none

Defaults

  • Default page size: 50; maximum: 100.
  • Default order: kind ascending, then name ascending.

Set expand=true to inline the dataset.record brief (label,
description, iconUrl, contentType) on every dataset reference.

Set sampleValues=true to attach a bounded sample of each tag's
values (see the sampleValues parameter).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

CEL expression that response tags must match. Must evaluate to
bool. Must be URL-encoded. See the operation description for
available fields.

string

CSV CEL expressions; default kind,name. Prefix an item with -
for descending. Supported expressions evaluate to comparable values
(e.g. name, kind, datasetCount).

int64

Number of items to skip before starting to collect the result set

int64

Maximum number of items to return in the response

boolean

Whether to expand resources referenced in the response to include additional fields

boolean
Defaults to false

When true, each returned tag includes up to 20 sample values in
sampleValues. This is a bounded, non-paginated sample, NOT the
full value set. Sampling is best-effort: sampleValues may be
empty or absent for a tag whose values could not be retrieved.
Use GET /v1/tags/values to search across tag values.

Responses

Language
Credentials
Bearer
Authorization: Bearer <customerid> <apitoken>
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json