--- title: Create a sharable link to a query result --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Workers](https://developers.cloudflare.com/api/go/resources/workers) [Observability](https://developers.cloudflare.com/api/go/resources/workers/subresources/observability) [Shared Queries](https://developers.cloudflare.com/api/go/resources/workers/subresources/observability/subresources/shared_queries) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create a sharable link to a query result client.Workers.Observability.SharedQueries.New(ctx, params) (\*[ObservabilitySharedQueryNewResponse](), error) POST/accounts/{account\_id}/workers/observability/shared/query Shared queries store the results of a previously run query, allowing you to share the results with others. ##### Security
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
User Service Key Used when interacting with the Origin CA certificates API. View/change your key. **Example:**X-Auth-User-Service-Key: v1.0-144c9defac04969c7bfad8ef-631a41d003a32d25fe878081ef365c49503f7fada600da935e2851a1c7326084b85cbf6429c4b859de8475731dc92a9c329631e6d59e6c73da7b198497172b4cefe071d90d0f5d2719
##### Accepted Permissions (at least one required) `Workers Observability Write` ##### ParametersExpand Collapse
params ObservabilitySharedQueryNewParams AccountID param.Field\[string] Path param: Your Cloudflare account ID. Link to this property QueryID param.Field\[string] Body param: Identifier for the query. When parameters are omitted, this ID is used to load a previously saved query’s parameters. When providing parameters inline, pass any identifier (e.g. an ad-hoc ID). Link to this property
Timeframe param.Field\[ObservabilitySharedQueryNewParamsTimeframe] Body param: Timeframe for the query using Unix timestamps in milliseconds. ‘from’ must be earlier than ‘to’. Narrower timeframes produce faster responses and more specific results. From int64 Start timestamp for the query timeframe. Unix timestamp in milliseconds maximum253402300799999 minimum0 Link to this property To int64 End timestamp for the query timeframe. Unix timestamp in milliseconds maximum253402300799999 minimum0 Link to this property
Link to this property Chart param.Field\[bool]Optional Body param: When true, includes time-series data in the response. Link to this property
ChartType param.Field\[ObservabilitySharedQueryNewParamsChartType]Optional Body param: Controls the SQL shape and response payload for the ‘calculations’ view. Omitted or ‘timeseries\_and\_aggregate’: current behaviour — both the time-series and aggregate queries. ‘timeseries’: time-series only. ‘aggregate’: aggregate only. ‘distribution’: a bucketed 2D histogram (time × value buckets) returned in ‘distribution’ instead of ‘calculations’. ‘distribution’ is not compatible with ‘compare’ — combining them returns a 400. const ObservabilitySharedQueryNewParamsChartTypeTimeseriesAndAggregate ObservabilitySharedQueryNewParamsChartType = "timeseries\_and\_aggregate" Link to this property const ObservabilitySharedQueryNewParamsChartTypeTimeseries ObservabilitySharedQueryNewParamsChartType = "timeseries" Link to this property const ObservabilitySharedQueryNewParamsChartTypeAggregate ObservabilitySharedQueryNewParamsChartType = "aggregate" Link to this property const ObservabilitySharedQueryNewParamsChartTypeDistribution ObservabilitySharedQueryNewParamsChartType = "distribution" Link to this property
Link to this property Compare param.Field\[bool]Optional Body param: When true, includes a comparison dataset from the previous time period of equal length. Link to this property
DistributionScale param.Field\[ObservabilitySharedQueryNewParamsDistributionScale]Optional Body param: Value-axis bucketing for chartType ‘distribution’. Omitted or ‘log’: geometric buckets, best for heavy-tailed latency. ‘linear’: fixed-width buckets, clearer for narrow or additive ranges. Ignored for other chartTypes. The response echoes the scheme used in distribution.bucketMode. const ObservabilitySharedQueryNewParamsDistributionScaleLog ObservabilitySharedQueryNewParamsDistributionScale = "log" Link to this property const ObservabilitySharedQueryNewParamsDistributionScaleLinear ObservabilitySharedQueryNewParamsDistributionScale = "linear" Link to this property
Link to this property Dry param.Field\[bool]Optional Body param: When true, executes the query without persisting the results. Useful for validation or previewing. Link to this property Granularity param.Field\[float64]Optional Body param: Number of time-series buckets. Only used when view is ‘calculations’. Omit to let the system auto-detect an appropriate granularity. Link to this property IgnoreSeries param.Field\[bool]Optional Body param: When true, omits time-series data from the response and returns only aggregated values. Reduces response size when series are not needed. Link to this property Limit param.Field\[float64]Optional Body param: Maximum number of events to return when view is ‘events’. Also controls the number of group-by rows when view is ‘calculations’. maximum2000 Link to this property Offset param.Field\[string]Optional Body param: Cursor for pagination in event, trace, invocation, and agent views. Pass the $metadata.id of the last event, the trace cursor, or AgentRun.id to fetch the next page. Link to this property OffsetBy param.Field\[float64]Optional Body param: Numeric offset for paginating grouped/pattern results (top-N lists). Use together with limit. Not used by cursor-based pagination. Link to this property OffsetDirection param.Field\[string]Optional Body param: Pagination direction: ‘next’ for forward, ‘prev’ for backward. Link to this property
Parameters param.Field\[ObservabilitySharedQueryNewParamsParameters]Optional Body param: Query parameters defining what data to retrieve — filters, calculations, group-bys, and ordering. In practice this should always be provided for ad-hoc queries. Only omit when executing a previously saved query by queryId. Use the keys and values endpoints to discover available fields before building filters.
Calculations \[]ObservabilitySharedQueryNewParamsParametersCalculationOptional Aggregation calculations to compute (e.g. count, avg, p99). Each calculation produces aggregate values and optional time-series data. One of the following:
type ObservabilitySharedQueryNewParamsParametersCalculationsObject struct{…}
Operator ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator Aggregation operator to apply. Examples: count, avg, sum, min, max, median, p90, p95, p99, uniq, stddev, variance. One of the following: const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorCount ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "count" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorCountUppercase ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "COUNT" Link to this property
Link to this property Alias stringOptional Custom label for this calculation in the results. Useful for distinguishing multiple calculations. Link to this property Key stringOptional Field name to calculate over. Must exist in the data. Verify with the keys endpoint. Required for every operator except count, which aggregates whole rows and may omit it. Link to this property
KeyType ObservabilitySharedQueryNewParamsParametersCalculationsObjectKeyTypeOptional Data type of the key. Required when key is provided to ensure correct aggregation. One of the following: const ObservabilitySharedQueryNewParamsParametersCalculationsObjectKeyTypeString ObservabilitySharedQueryNewParamsParametersCalculationsObjectKeyType = "string" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectKeyTypeNumber ObservabilitySharedQueryNewParamsParametersCalculationsObjectKeyType = "number" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectKeyTypeBoolean ObservabilitySharedQueryNewParamsParametersCalculationsObjectKeyType = "boolean" Link to this property
Link to this property
Link to this property
type ObservabilitySharedQueryNewParamsParametersCalculationsObject struct{…} Key string Field name to calculate over. Must exist in the data. Verify with the keys endpoint. Required for every operator except count, which aggregates whole rows and may omit it. Link to this property
Operator ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator Aggregation operator to apply. Examples: count, avg, sum, min, max, median, p90, p95, p99, uniq, stddev, variance. One of the following: const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorUniq ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "uniq" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorMax ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "max" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorMin ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "min" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorSum ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "sum" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorAvg ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "avg" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorMedian ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "median" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorP001 ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "p001" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorP01 ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "p01" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorP05 ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "p05" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorP10 ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "p10" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorP25 ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "p25" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorP75 ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "p75" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorP90 ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "p90" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorP95 ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "p95" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorP99 ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "p99" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorP999 ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "p999" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorStddev ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "stddev" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorVariance ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "variance" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorCountDistinct ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "COUNT\_DISTINCT" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorMaxUppercase ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "MAX" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorMinUppercase ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "MIN" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorSumUppercase ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "SUM" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorAvgUppercase ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "AVG" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorMedianUppercase ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "MEDIAN" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorP001Uppercase ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "P001" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorP01Uppercase ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "P01" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorP05Uppercase ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "P05" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorP10Uppercase ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "P10" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorP25Uppercase ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "P25" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorP75Uppercase ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "P75" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorP90Uppercase ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "P90" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorP95Uppercase ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "P95" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorP99Uppercase ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "P99" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorP999Uppercase ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "P999" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorStddevUppercase ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "STDDEV" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperatorVarianceUppercase ObservabilitySharedQueryNewParamsParametersCalculationsObjectOperator = "VARIANCE" Link to this property
Link to this property Alias stringOptional Custom label for this calculation in the results. Useful for distinguishing multiple calculations. Link to this property
KeyType ObservabilitySharedQueryNewParamsParametersCalculationsObjectKeyTypeOptional Data type of the key. Required when key is provided to ensure correct aggregation. One of the following: const ObservabilitySharedQueryNewParamsParametersCalculationsObjectKeyTypeString ObservabilitySharedQueryNewParamsParametersCalculationsObjectKeyType = "string" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectKeyTypeNumber ObservabilitySharedQueryNewParamsParametersCalculationsObjectKeyType = "number" Link to this property const ObservabilitySharedQueryNewParamsParametersCalculationsObjectKeyTypeBoolean ObservabilitySharedQueryNewParamsParametersCalculationsObjectKeyType = "boolean" Link to this property
Link to this property
Link to this property
Link to this property Datasets \[]stringOptional Datasets to query. Leave empty to query all available datasets. Link to this property
FilterCombination ObservabilitySharedQueryNewParamsParametersFilterCombinationOptional Logical operator for combining top-level filters: ‘and’ (all must match) or ‘or’ (any must match). Defaults to ‘and’. One of the following: const ObservabilitySharedQueryNewParamsParametersFilterCombinationAnd ObservabilitySharedQueryNewParamsParametersFilterCombination = "and" Link to this property const ObservabilitySharedQueryNewParamsParametersFilterCombinationOr ObservabilitySharedQueryNewParamsParametersFilterCombination = "or" Link to this property const ObservabilitySharedQueryNewParamsParametersFilterCombinationAndUppercase ObservabilitySharedQueryNewParamsParametersFilterCombination = "AND" Link to this property const ObservabilitySharedQueryNewParamsParametersFilterCombinationOrUppercase ObservabilitySharedQueryNewParamsParametersFilterCombination = "OR" Link to this property
Link to this property
Filters \[]ObservabilitySharedQueryNewParamsParametersFilterOptional Filters to narrow query results. Use the keys and values endpoints to discover available fields before building filters. Supports nested groups via kind: ‘group’. Maximum nesting depth is 4. One of the following:
type ObservabilitySharedQueryNewParamsParametersFiltersObject struct{…}
FilterCombination ObservabilitySharedQueryNewParamsParametersFiltersObjectFilterCombination One of the following: const ObservabilitySharedQueryNewParamsParametersFiltersObjectFilterCombinationAnd ObservabilitySharedQueryNewParamsParametersFiltersObjectFilterCombination = "and" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFilterCombinationOr ObservabilitySharedQueryNewParamsParametersFiltersObjectFilterCombination = "or" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFilterCombinationAndUppercase ObservabilitySharedQueryNewParamsParametersFiltersObjectFilterCombination = "AND" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFilterCombinationOrUppercase ObservabilitySharedQueryNewParamsParametersFiltersObjectFilterCombination = "OR" Link to this property
Link to this property
Filters \[]ObservabilitySharedQueryNewParamsParametersFiltersObjectFilter One of the following:
type ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersObject struct{…}
FilterCombination ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersObjectFilterCombination One of the following: const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersObjectFilterCombinationAnd ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersObjectFilterCombination = "and" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersObjectFilterCombinationOr ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersObjectFilterCombination = "or" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersObjectFilterCombinationAndUppercase ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersObjectFilterCombination = "AND" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersObjectFilterCombinationOrUppercase ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersObjectFilterCombination = "OR" Link to this property
Link to this property Filters \[]unknown Link to this property Kind ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersObjectKind Link to this property
Link to this property
type ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeaf struct{…} A filter condition applied to query results. Use the keys and values endpoints to discover available fields and their values before constructing filters. Key string Filter field name. Use verified keys from previous query results or the keys endpoint. Common keys include $metadata.service, $metadata.origin, $metadata.trigger, $metadata.message, and $metadata.error. Link to this property
Operation ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation Comparison operator. String operators: includes, not\_includes, starts\_with, ends\_with, regex. Existence: exists, is\_null. Set membership: in, not\_in (comma-separated values). Numeric: eq, neq, gt, gte, lt, lte. One of the following: const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationIncludes ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "includes" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationNotIncludes ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "not\_includes" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationStartsWith ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "starts\_with" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationEndsWith ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "ends\_with" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationRegex ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "regex" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationExists ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "exists" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationIsNull ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "is\_null" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationIn ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "in" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationNotIn ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "not\_in" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationEq ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "eq" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationNeq ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "neq" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationGt ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "gt" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationGte ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "gte" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationLt ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "lt" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationLte ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "lte" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationEquals ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "=" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationNotEquals ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "!=" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationGreater ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = ">" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationGreaterOrEquals ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = ">=" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationLess ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "<" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationLessOrEquals ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "<=" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationIncludesUppercase ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "INCLUDES" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationDoesNotInclude ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "DOES\_NOT\_INCLUDE" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationMatchRegex ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "MATCH\_REGEX" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationExistsUppercase ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "EXISTS" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationDoesNotExist ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "DOES\_NOT\_EXIST" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationInUppercase ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "IN" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationNotInUppercase ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "NOT\_IN" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationStartsWithUppercase ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "STARTS\_WITH" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperationEndsWithUppercase ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafOperation = "ENDS\_WITH" Link to this property
Link to this property
Type ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafType Data type of the filter field. Must match the actual type of the key being filtered. One of the following: const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafTypeString ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafType = "string" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafTypeNumber ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafType = "number" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafTypeBoolean ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafType = "boolean" Link to this property
Link to this property Kind ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafKindOptional Discriminator for leaf filter nodes. Always ‘filter’ when present; may be omitted. Link to this property
Value ObservabilitySharedQueryNewParamsParametersFiltersObjectFiltersWorkersObservabilityFilterLeafValueUnionOptional Comparison value. Must match actual values in your data — verify with the values endpoint. Ensure the value type (string/number/boolean) matches the field type. String comparisons are case-sensitive. Regex uses RE2 syntax (no lookaheads/lookbehinds). One of the following: UnionString Link to this property UnionFloat Link to this property UnionBool Link to this property
Link to this property
Link to this property
Link to this property Kind ObservabilitySharedQueryNewParamsParametersFiltersObjectKind Link to this property
Link to this property
type ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeaf struct{…} A filter condition applied to query results. Use the keys and values endpoints to discover available fields and their values before constructing filters. Key string Filter field name. Use verified keys from previous query results or the keys endpoint. Common keys include $metadata.service, $metadata.origin, $metadata.trigger, $metadata.message, and $metadata.error. Link to this property
Operation ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation Comparison operator. String operators: includes, not\_includes, starts\_with, ends\_with, regex. Existence: exists, is\_null. Set membership: in, not\_in (comma-separated values). Numeric: eq, neq, gt, gte, lt, lte. One of the following: const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationIncludes ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "includes" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationNotIncludes ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "not\_includes" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationStartsWith ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "starts\_with" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationEndsWith ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "ends\_with" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationRegex ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "regex" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationExists ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "exists" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationIsNull ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "is\_null" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationIn ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "in" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationNotIn ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "not\_in" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationEq ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "eq" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationNeq ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "neq" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationGt ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "gt" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationGte ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "gte" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationLt ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "lt" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationLte ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "lte" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationEquals ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "=" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationNotEquals ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "!=" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationGreater ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = ">" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationGreaterOrEquals ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = ">=" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationLess ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "<" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationLessOrEquals ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "<=" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationIncludesUppercase ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "INCLUDES" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationDoesNotInclude ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "DOES\_NOT\_INCLUDE" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationMatchRegex ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "MATCH\_REGEX" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationExistsUppercase ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "EXISTS" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationDoesNotExist ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "DOES\_NOT\_EXIST" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationInUppercase ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "IN" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationNotInUppercase ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "NOT\_IN" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationStartsWithUppercase ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "STARTS\_WITH" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperationEndsWithUppercase ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafOperation = "ENDS\_WITH" Link to this property
Link to this property
Type ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafType Data type of the filter field. Must match the actual type of the key being filtered. One of the following: const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafTypeString ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafType = "string" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafTypeNumber ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafType = "number" Link to this property const ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafTypeBoolean ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafType = "boolean" Link to this property
Link to this property Kind ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafKindOptional Discriminator for leaf filter nodes. Always ‘filter’ when present; may be omitted. Link to this property
Value ObservabilitySharedQueryNewParamsParametersFiltersWorkersObservabilityFilterLeafValueUnionOptional Comparison value. Must match actual values in your data — verify with the values endpoint. Ensure the value type (string/number/boolean) matches the field type. String comparisons are case-sensitive. Regex uses RE2 syntax (no lookaheads/lookbehinds). One of the following: UnionString Link to this property UnionFloat Link to this property UnionBool Link to this property
Link to this property
Link to this property
Link to this property
GroupBys \[]ObservabilitySharedQueryNewParamsParametersGroupByOptional Fields to group calculation results by. Only applicable when the query view is ‘calculations’. Produces per-group aggregate values.
Type ObservabilitySharedQueryNewParamsParametersGroupBysType Data type of the group-by field. One of the following: const ObservabilitySharedQueryNewParamsParametersGroupBysTypeString ObservabilitySharedQueryNewParamsParametersGroupBysType = "string" Link to this property const ObservabilitySharedQueryNewParamsParametersGroupBysTypeNumber ObservabilitySharedQueryNewParamsParametersGroupBysType = "number" Link to this property const ObservabilitySharedQueryNewParamsParametersGroupBysTypeBoolean ObservabilitySharedQueryNewParamsParametersGroupBysType = "boolean" Link to this property
Link to this property Value string Field name to group results by (e.g. $metadata.service, $metadata.statusCode). Link to this property
Link to this property
Havings \[]ObservabilitySharedQueryNewParamsParametersHavingOptional Post-aggregation filters applied to calculation results. Use to filter groups after aggregation (e.g. only groups where count > 100). Key string Calculation alias or operator to filter on after aggregation. Link to this property
Operation ObservabilitySharedQueryNewParamsParametersHavingsOperation Numeric comparison operator: eq, neq, gt, gte, lt, lte. One of the following: const ObservabilitySharedQueryNewParamsParametersHavingsOperationEq ObservabilitySharedQueryNewParamsParametersHavingsOperation = "eq" Link to this property const ObservabilitySharedQueryNewParamsParametersHavingsOperationNeq ObservabilitySharedQueryNewParamsParametersHavingsOperation = "neq" Link to this property const ObservabilitySharedQueryNewParamsParametersHavingsOperationGt ObservabilitySharedQueryNewParamsParametersHavingsOperation = "gt" Link to this property const ObservabilitySharedQueryNewParamsParametersHavingsOperationGte ObservabilitySharedQueryNewParamsParametersHavingsOperation = "gte" Link to this property const ObservabilitySharedQueryNewParamsParametersHavingsOperationLt ObservabilitySharedQueryNewParamsParametersHavingsOperation = "lt" Link to this property const ObservabilitySharedQueryNewParamsParametersHavingsOperationLte ObservabilitySharedQueryNewParamsParametersHavingsOperation = "lte" Link to this property
Link to this property Value float64 Threshold value to compare the calculation result against. Link to this property
Link to this property Limit int64Optional Maximum number of group-by rows to return in calculation results. A value of 10 is a sensible default for most use cases. maximum2000 minimum0 Link to this property
Needle ObservabilitySharedQueryNewParamsParametersNeedleOptional Full-text search expression applied across all event fields. Matches events containing the specified text.
Value ObservabilitySharedQueryNewParamsParametersNeedleValueUnion The text or pattern to search for. maxLength1000 One of the following: UnionString Link to this property UnionFloat Link to this property UnionBool Link to this property
Link to this property IsRegex boolOptional When true, treats the value as a regular expression (RE2 syntax). Link to this property MatchCase boolOptional When true, performs a case-sensitive search. Defaults to case-insensitive. Link to this property
Link to this property
OrderBy ObservabilitySharedQueryNewParamsParametersOrderByOptional Ordering for grouped calculation results. Only effective when a group-by is present. Value string Alias of the calculation to order results by. Must match the alias (or operator) of a calculation in the query. Link to this property
Order ObservabilitySharedQueryNewParamsParametersOrderByOrderOptional Sort direction: ‘asc’ for ascending, ‘desc’ for descending. One of the following: const ObservabilitySharedQueryNewParamsParametersOrderByOrderAsc ObservabilitySharedQueryNewParamsParametersOrderByOrder = "asc" Link to this property const ObservabilitySharedQueryNewParamsParametersOrderByOrderDesc ObservabilitySharedQueryNewParamsParametersOrderByOrder = "desc" Link to this property
Link to this property
Link to this property
Link to this property
View param.Field\[ObservabilitySharedQueryNewParamsView]Optional Body param: Controls the shape of the response. ‘events’: individual log lines matching the query. ‘calculations’: aggregated metrics (count, avg, p99, etc.) with optional group-by breakdowns and time-series. ‘invocations’: events grouped by request ID. ‘traces’: distributed trace summaries. ‘agents’: agent-specific trace summaries. const ObservabilitySharedQueryNewParamsViewTraces ObservabilitySharedQueryNewParamsView = "traces" Link to this property const ObservabilitySharedQueryNewParamsViewEvents ObservabilitySharedQueryNewParamsView = "events" Link to this property const ObservabilitySharedQueryNewParamsViewCalculations ObservabilitySharedQueryNewParamsView = "calculations" Link to this property const ObservabilitySharedQueryNewParamsViewInvocations ObservabilitySharedQueryNewParamsView = "invocations" Link to this property const ObservabilitySharedQueryNewParamsViewRequests ObservabilitySharedQueryNewParamsView = "requests" Link to this property const ObservabilitySharedQueryNewParamsViewAgents ObservabilitySharedQueryNewParamsView = "agents" Link to this property
Link to this property
[Link to this property](<#(resource)%20workers.observability.shared_queries%20%3E%20(method)%20create%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type ObservabilitySharedQueryNewResponse struct{…} ID string Specify the ID of the shared query. Link to this property
[Link to this property](<#(resource)%20workers.observability.shared_queries%20%3E%20(model)%20ObservabilitySharedQueryNewResponse%20%3E%20(schema)>) ### Create a sharable link to a query result Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/workers" ) func main() { client := cloudflare.NewClient( option.WithAPIKey("144c9defac04969c7bfad8efaa8ea194"), option.WithAPIEmail("user@example.com"), ) sharedQuery, err := client.Workers.Observability.SharedQueries.New(context.TODO(), workers.ObservabilitySharedQueryNewParams{ AccountID: cloudflare.F("account_id"), QueryID: cloudflare.F("queryId"), Timeframe: cloudflare.F(workers.ObservabilitySharedQueryNewParamsTimeframe{ From: cloudflare.F(int64(0)), To: cloudflare.F(int64(0)), }), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", sharedQuery.ID) } ``` 200 example ``` { "errors": [ { "message": "message" } ], "messages": [ { "message": "Successful request" } ], "result": { "id": "id" }, "success": true } ``` ##### Returns Examples 200 example ``` { "errors": [ { "message": "message" } ], "messages": [ { "message": "Successful request" } ], "result": { "id": "id" }, "success": true } ```