Wavefront (version v1.*.*)

id (required)#

Type: string

id (required)#

Type: string

$body#

The list of roles that should be added to the account

Type: array

[ "string" ]

id (required)#

Type: string

$body#

The list of user groups that should be added to the account

Type: array

[ "string" ]

$body#

Type: array

[ {
  "viewAcl" : [ "string" ],
  "modifyAcl" : [ "string" ],
  "entityId" : "The entity Id"
} ]

id (required)#

Type: string

tagValue (required)#

Type: string

id (required)#

Type: string

$body#

List of users and user groups thatshould be added to role

Type: array

[ "string" ]

$body#

Type: array

[ {
  "viewAcl" : [ "string" ],
  "modifyAcl" : [ "string" ],
  "entityId" : "The entity Id"
} ]

id (required)#

Type: string

tagValue (required)#

Type: string

id (required)#

Type: string

tagValue (required)#

Type: string

$body#

Example Body:
{
"ingestionPolicyId": "Ingestion policy identifier",
"accounts": [
"account1",
"account2",
"account3"
],
}

Type: object

{
  "accounts" : [ "string" ],
  "ingestionPolicyId" : "The unique identifier of the ingestion policy"
}

id (required)#

Type: string

$body#

List of roles that should be added to user group

Type: array

[ "string" ]

id (required)#

Type: string

tagValue (required)#

Type: string

id (required)#

Type: string

tagValue (required)#

Type: string

id (required)#

Type: string

$body#

The list of user groups that should be added to the account

Type: array

[ "string" ]

id (required)#

Type: string

$body#

List of users that should be added to user group

Type: array

[ "string" ]

id (required)#

Type: string

name#

Type: string

v#

Type: integer

id (required)#

Type: string

$body#

Example Classic Body:
{
"name": "Alert Name",
"target": "success@simulator.amazonses.com",
"condition": "ts(~sample.cpu.loadavg.1m) > 1",
"displayExpression": "ts(~sample.cpu.loadavg.1m)",
"minutes": 5,
"resolveAfterMinutes": 2,
"severity": "INFO",
"additionalInformation": "Additional Info",
"tags": {
"customerTags": [
"alertTag1"
]
}
}
Example Threshold Body:
{
"name": "Alert Name",
"alertType": "THRESHOLD",
"conditions": {
"info": "ts(~sample.cpu.loadavg.1m) > 0",
"warn": "ts(~sample.cpu.loadavg.1m) > 2"
},
"displayExpression": "ts(~sample.cpu.loadavg.1m)",
"minutes": 5,
"additionalInformation": "conditions value entry needs to be of the form: displayExpression operator threshold"
}

Type: object

{
  "createUserId" : "string",
  "notificationResendFrequencyMinutes" : "How often to re-trigger a continually failing alert. If absent or <= 0, no retriggering occurs",
  "pointsScannedAtLastQuery" : "A derived field recording the number of data points scanned when the system last computed this alert's condition",
  "acl" : {
    "canView" : [ "string" ],
    "canModify" : [ "string" ]
  },
  "updaterId" : "string",
  "alertsLastDay" : "integer",
  "failingHostLabelPairLinks" : [ "string" ],
  "displayExpressionQBEnabled" : "Whether the display expression query was created using the Query Builder. Default false",
  "id" : "string",
  "resolveAfterMinutes" : "The number of consecutive minutes that a firing series matching the condition query must evaluate to \"false\" (zero value) before the alert resolves. When unset, this defaults to the same value as \"minutes\"",
  "alertsLastMonth" : "integer",
  "additionalInformation" : "User-supplied additional explanatory information for this alert. Useful for linking runbooks, mitigations,, etc",
  "evaluateRealtimeData" : "Whether to alert on the real-time ingestion stream (may be noisy due to late data)",
  "targetInfo" : [ {
    "method" : "Notification method of the alert target",
    "name" : "Name of the alert target",
    "id" : "ID of the alert target"
  } ],
  "lastErrorMessage" : "The last error encountered when running this alert's condition query",
  "updateUserId" : "The user that last updated this alert",
  "minutes" : "The number of consecutive minutes that a series matching the condition query must evaluate to \"true\" (non-zero value) before the alert fires",
  "created" : "When this alert was created, in epoch millis",
  "failingHostLabelPairs" : [ {
    "severity" : "string. Possible values: INFO | SMOKE | WARN | SEVERE",
    "host" : "Source (or host). \"Source\" and \"host\" are synonyms in current versions of wavefront, but the host terminology is deprecated",
    "firing" : "integer",
    "label" : "string",
    "tags" : "object",
    "observed" : "integer"
  } ],
  "conditionQBSerialization" : "The special serialization of the Query Builder that corresponds to the condition query. Applicable only when conditionQBEnabled is true",
  "systemOwned" : "Whether this alert is system-owned and not writeable",
  "processRateMinutes" : "The interval between checks for this alert, in minutes. Defaults to 1 minute",
  "sortAttr" : "Attribute used for default alert sort that is derived from state and severity",
  "numPointsInFailureFrame" : "Number of points scanned in alert query time frame.",
  "tags" : {
    "customerTags" : [ "string" ]
  },
  "condition" : "A Wavefront query that is evaluated at regular intervals (default 1m). The alert fires and notifications are triggered when a data series matching this query evaluates to a non-zero value for a set number of consecutive minutes",
  "targetEndpoints" : [ "string" ],
  "notificants" : [ "string" ],
  "inMaintenanceHostLabelPairs" : [ {
    "severity" : "string. Possible values: INFO | SMOKE | WARN | SEVERE",
    "host" : "Source (or host). \"Source\" and \"host\" are synonyms in current versions of wavefront, but the host terminology is deprecated",
    "firing" : "integer",
    "label" : "string",
    "tags" : "object",
    "observed" : "integer"
  } ],
  "noDataEvent" : {
    "alertTags" : [ "string" ],
    "canClose" : "boolean",
    "summarizedEvents" : "In some event queries, multiple events that occur nearly simultaneously are summarized under a single event. This value specifies the number of events summarized under this one",
    "isEphemeral" : "Whether the event is an artificial event generated by a literal expression or alert backtesting, i.e. not stored in the Wavefront backend",
    "creatorType" : [ "string. Possible values: USER | ALERT | SYSTEM" ],
    "createdEpochMillis" : "integer",
    "hosts" : [ "string" ],
    "creatorId" : "string",
    "annotations" : "A string->string map of additional annotations on the event",
    "isUserEvent" : "Whether this event was created by a user, versus the system. Default: system",
    "updatedEpochMillis" : "integer",
    "tags" : [ "string" ],
    "createdAt" : "integer",
    "updaterId" : "string",
    "name" : "The name of the event. If 'annotations.prettyName' is present, 'name' will be equivalent to that value",
    "runningState" : "string. Possible values: ONGOING | PENDING | ENDED",
    "startTime" : "Start time of the event, in epoch millis. If the JSON value is missing or set to 0, startTime will be set to the current time",
    "canDelete" : "boolean",
    "id" : "string",
    "endTime" : "End time of the event, in epoch millis. Set to startTime + 1 for an instantaneous event",
    "metricsUsed" : [ "string" ],
    "table" : "The customer to which the event belongs",
    "dimensions" : "A string-> map of additional dimension info on the event",
    "updatedAt" : "integer"
  },
  "name" : "Required string",
  "displayExpression" : "A second query whose results are displayed in the alert user interface instead of the condition query. This field is often used to display a version of the condition query with Boolean operators removed so that numerical values are plotted",
  "conditions" : "Multi - alert conditions.",
  "lastProcessedMillis" : "The time when this alert was last checked, in epoch millis",
  "updated" : "When the alert was last updated, in epoch millis",
  "includeObsoleteMetrics" : "Whether to include obsolete metrics in alert query",
  "status" : [ "string" ],
  "alertsLastWeek" : "integer",
  "hidden" : "boolean",
  "lastFailedTime" : "The time of the last error encountered when running this alert's condition query, in epoch millis",
  "creatorId" : "string",
  "snoozed" : "The until which time this alert is snoozed (not checked), in epoch millis. A negative value implies the alert is snoozed indefinitely",
  "targets" : "Targets for severity.",
  "prefiringHostLabelPairs" : [ {
    "severity" : "string. Possible values: INFO | SMOKE | WARN | SEVERE",
    "host" : "Source (or host). \"Source\" and \"host\" are synonyms in current versions of wavefront, but the host terminology is deprecated",
    "firing" : "integer",
    "label" : "string",
    "tags" : "object",
    "observed" : "integer"
  } ],
  "displayExpressionQBSerialization" : "The special serialization of the Query Builder that corresponds to the display expression query. Applicable only when displayExpressionQBEnabled is true",
  "queryFailing" : "Whether there was an exception when the alert condition last ran",
  "event" : {
    "alertTags" : [ "string" ],
    "canClose" : "boolean",
    "summarizedEvents" : "In some event queries, multiple events that occur nearly simultaneously are summarized under a single event. This value specifies the number of events summarized under this one",
    "isEphemeral" : "Whether the event is an artificial event generated by a literal expression or alert backtesting, i.e. not stored in the Wavefront backend",
    "creatorType" : [ "string. Possible values: USER | ALERT | SYSTEM" ],
    "createdEpochMillis" : "integer",
    "hosts" : [ "string" ],
    "creatorId" : "string",
    "annotations" : "A string->string map of additional annotations on the event",
    "isUserEvent" : "Whether this event was created by a user, versus the system. Default: system",
    "updatedEpochMillis" : "integer",
    "tags" : [ "string" ],
    "createdAt" : "integer",
    "updaterId" : "string",
    "name" : "The name of the event. If 'annotations.prettyName' is present, 'name' will be equivalent to that value",
    "runningState" : "string. Possible values: ONGOING | PENDING | ENDED",
    "startTime" : "Start time of the event, in epoch millis. If the JSON value is missing or set to 0, startTime will be set to the current time",
    "canDelete" : "boolean",
    "id" : "string",
    "endTime" : "End time of the event, in epoch millis. Set to startTime + 1 for an instantaneous event",
    "metricsUsed" : [ "string" ],
    "table" : "The customer to which the event belongs",
    "dimensions" : "A string-> map of additional dimension info on the event",
    "updatedAt" : "integer"
  },
  "metricsUsed" : [ "string" ],
  "severity" : "Severity of the alert",
  "hostsUsed" : [ "string" ],
  "alertType" : "Alert type.",
  "systemAlertVersion" : "If this is a system alert, the version of it",
  "createdEpochMillis" : "integer",
  "lastQueryTime" : "Last query time of the alert, averaged on hourly basis",
  "conditionQBEnabled" : "Whether the condition query was created using the Query Builder. Default false",
  "updatedEpochMillis" : "integer",
  "inTrash" : "boolean",
  "orphan" : "boolean",
  "modifyAclAccess" : "Whether the user has modify ACL access to the alert.",
  "activeMaintenanceWindows" : [ "string" ],
  "severityList" : [ "string. Possible values: INFO | SMOKE | WARN | SEVERE" ],
  "target" : "The email address or integration endpoint (such as PagerDuty or web hook) to notify when the alert status changes",
  "lastNotificationMillis" : "When this alert last caused a notification, in epoch millis",
  "deleted" : "boolean",
  "lastEventTime" : "Start time (in epoch millis) of the last event associated with this alert."
}

$body#

Example Body:
{
"name":"CloudWatch integration",
"service":"CLOUDWATCH",
"cloudWatch":{
"baseCredentials":{
"roleArn":"arn:aws:iam::<accountid>:role/<rolename>"
},
"metricFilterRegex":"^aws.(sqs|ec2|ebs|elb).*$",
"pointTagFilterRegex":"(region|name)"
},
"serviceRefreshRateInMins":5
}

Type: object

{
  "lastError" : "Digest of the last error encountered by Wavefront servers when fetching data using this integration",
  "tesla" : {
    "email" : "Email address for Tesla account login"
  },
  "creatorId" : "string",
  "lastMetricCount" : "Number of metrics / events ingested by this integration the last time it ran",
  "cloudTrail" : {
    "bucketName" : "Name of the S3 bucket where CloudTrail logs are stored",
    "prefix" : "The common prefix, if any, appended to all CloudTrail log files",
    "baseCredentials" : {
      "roleArn" : "The Role ARN that the customer has created in AWS IAM to allow access to Wavefront",
      "externalId" : "The external id corresponding to the Role ARN"
    },
    "filterRule" : "Rule to filter cloud trail log event.",
    "region" : "The AWS region of the S3 bucket where CloudTrail logs are stored"
  },
  "appDynamics" : {
    "controllerName" : "Name of the SaaS controller.",
    "enableIndividualNodeMetrics" : "Boolean flag to control Individual Node metric injection.",
    "enableRollup" : "Set this to 'false' to get separate results for all values within the time range, by default it is 'true'.",
    "appFilterRegex" : [ "string" ],
    "userName" : "Username is combination of userName and the account name.",
    "enableErrorMetrics" : "Boolean flag to control Error metric injection.",
    "enableServiceEndpointMetrics" : "Boolean flag to control Service End point metric injection.",
    "enableBusinessTrxMetrics" : "Boolean flag to control Business Transaction metric injection.",
    "enableOverallPerfMetrics" : "Boolean flag to control Overall Performance metric injection.",
    "encryptedPassword" : "Password for AppDynamics user.",
    "enableBackendMetrics" : "Boolean flag to control Backend metric injection.",
    "enableAppInfraMetrics" : "Boolean flag to control Application Infrastructure metric injection."
  },
  "additionalTags" : "A list of point tag key-values to add to every point ingested using this integration",
  "updaterId" : "string",
  "ec2" : {
    "baseCredentials" : {
      "roleArn" : "The Role ARN that the customer has created in AWS IAM to allow access to Wavefront",
      "externalId" : "The external id corresponding to the Role ARN"
    },
    "hostNameTags" : [ "string" ]
  },
  "gcp" : {
    "gcpJsonKey" : "Private key for a Google Cloud Platform (GCP) service account within your project. The account must at least be granted Monitoring Viewer permissions. This key must be in the JSON format generated by GCP. Use '{\"project_id\": \"%s\"}' to retain the existing key when updating.",
    "customMetricPrefix" : [ "string" ],
    "projectId" : "The Google Cloud Platform (GCP) project id.",
    "categoriesToFetch" : [ "string. Possible values: APPENGINE | BIGQUERY | BIGTABLE | CLOUDFUNCTIONS | CLOUDIOT | CLOUDSQL | CLOUDTASKS | COMPUTE | CONTAINER | DATAFLOW | DATAPROC | DATASTORE | FIREBASEDATABASE | FIREBASEHOSTING | FIRESTORE | INTERCONNECT | LOADBALANCING | LOGGING | ML | MONITORING | PUBSUB | REDIS | ROUTER | SERVICERUNTIME | SPANNER | STORAGE | TPU | VPN" ],
    "metricFilterRegex" : "A regular expression that a metric name must match (case-insensitively) in order to be ingested"
  },
  "disabled" : "True when an aws credential failed to authenticate.",
  "forceSave" : "boolean",
  "id" : "string",
  "azure" : {
    "resourceGroupFilter" : [ "string" ],
    "categoryFilter" : [ "string" ],
    "baseCredentials" : {
      "clientId" : "Client Id for an Azure service account within your project.",
      "clientSecret" : "Client Secret for an Azure service account within your project. Use 'saved_secret' to retain the client secret when updating.",
      "tenant" : "Tenant Id for an Azure service account within your project."
    },
    "metricFilterRegex" : "A regular expression that a metric name must match (case-insensitively) in order to be ingested"
  },
  "lastReceivedDataPointMs" : "Time that this integration last received a data point, in epoch millis",
  "createdEpochMillis" : "integer",
  "serviceRefreshRateInMins" : "Service refresh rate in minutes.",
  "lastErrorEvent" : {
    "alertTags" : [ "string" ],
    "canClose" : "boolean",
    "summarizedEvents" : "In some event queries, multiple events that occur nearly simultaneously are summarized under a single event. This value specifies the number of events summarized under this one",
    "isEphemeral" : "Whether the event is an artificial event generated by a literal expression or alert backtesting, i.e. not stored in the Wavefront backend",
    "creatorType" : [ "string. Possible values: USER | ALERT | SYSTEM" ],
    "createdEpochMillis" : "integer",
    "hosts" : [ "string" ],
    "creatorId" : "string",
    "annotations" : "A string->string map of additional annotations on the event",
    "isUserEvent" : "Whether this event was created by a user, versus the system. Default: system",
    "updatedEpochMillis" : "integer",
    "tags" : [ "string" ],
    "createdAt" : "integer",
    "updaterId" : "string",
    "name" : "The name of the event. If 'annotations.prettyName' is present, 'name' will be equivalent to that value",
    "runningState" : "string. Possible values: ONGOING | PENDING | ENDED",
    "startTime" : "Start time of the event, in epoch millis. If the JSON value is missing or set to 0, startTime will be set to the current time",
    "canDelete" : "boolean",
    "id" : "string",
    "endTime" : "End time of the event, in epoch millis. Set to startTime + 1 for an instantaneous event",
    "metricsUsed" : [ "string" ],
    "table" : "The customer to which the event belongs",
    "dimensions" : "A string-> map of additional dimension info on the event",
    "updatedAt" : "integer"
  },
  "cloudWatch" : {
    "instanceSelectionTags" : "A comma-separated white list of AWS instance tag-value pairs (in AWS). If the instance's AWS tags match this whitelist, CloudWatch data about this instance is ingested. Multiple entries are OR'ed",
    "pointTagFilterRegex" : "A regular expression that AWS tag key name must match (case-insensitively) in order to be ingested",
    "volumeSelectionTags" : "A comma-separated white list of AWS volume tag-value pairs (in AWS). If the volume's AWS tags match this whitelist, CloudWatch data about this volume is ingested. Multiple entries are OR'ed",
    "baseCredentials" : {
      "roleArn" : "The Role ARN that the customer has created in AWS IAM to allow access to Wavefront",
      "externalId" : "The external id corresponding to the Role ARN"
    },
    "metricFilterRegex" : "A regular expression that a CloudWatch metric name must match (case-insensitively) in order to be ingested",
    "namespaces" : [ "string" ]
  },
  "newRelic" : {
    "apiKey" : "New Relic REST API Key.",
    "appFilterRegex" : "A regular expression that a application name must match (case-insensitively) in order to collect metrics.",
    "newRelicMetricFilters" : [ {
      "appName" : "string",
      "metricFilterRegex" : "string"
    } ],
    "hostFilterRegex" : "A regular expression that a host name must match (case-insensitively) in order to collect metrics."
  },
  "lastProcessorId" : "Opaque id of the last Wavefront integrations service to act on this integration",
  "updatedEpochMillis" : "integer",
  "inTrash" : "boolean",
  "lastProcessingTimestamp" : "Time, in epoch millis, that this integration was last processed",
  "deleted" : "boolean",
  "gcpBilling" : {
    "gcpJsonKey" : "Private key for a Google Cloud Platform (GCP) service account within your project. The account must at least be granted Monitoring Viewer permissions. This key must be in the JSON format generated by GCP. Use '{\"project_id\": \"%s\"}' to retain the existing key when updating.",
    "gcpApiKey" : "API key for Google Cloud Platform (GCP). Use 'saved_api_key' to retain existing API key when updating",
    "projectId" : "The Google Cloud Platform (GCP) project id."
  },
  "service" : "A value denoting which cloud service this integration integrates with",
  "name" : "The human-readable name of this integration",
  "azureActivityLog" : {
    "categoryFilter" : [ "string. Possible values: ADMINISTRATIVE | SERVICEHEALTH | ALERT | AUTOSCALE | SECURITY" ],
    "baseCredentials" : {
      "clientId" : "Client Id for an Azure service account within your project.",
      "clientSecret" : "Client Secret for an Azure service account within your project. Use 'saved_secret' to retain the client secret when updating.",
      "tenant" : "Tenant Id for an Azure service account within your project."
    }
  },
  "lastErrorMs" : "Time, in epoch millis, of the last error encountered by Wavefront servers when fetching data using this integration"
}

$body#

Example Body:
{
"name": "Dashboard API example",
"id": "api-example",
"url": "api-example",
"description": "Dashboard Description",
"sections": [
{
"name": "Section 1",
"rows": [
{
"charts": [
{
"name": "Chart 1",
"description": "description1",
"sources": [
{
"name": "Source1",
"query": "ts()"
}
]
}
]
}
]
}
]
}

Type: object

{
  "parameterDetails" : "The current (as of Wavefront 4.0) JSON representation of dashboard parameters. This is a map from a parameter name to its representation",
  "hidden" : "boolean",
  "defaultStartTime" : "Default start time in milliseconds to query charts",
  "viewsLastWeek" : "integer",
  "forceV2UI" : "Whether to force this dashboard to use the V2 UI",
  "creatorId" : "string",
  "description" : "Human-readable description of the dashboard",
  "acl" : {
    "canView" : [ "string" ],
    "canModify" : [ "string" ]
  },
  "chartTitleColor" : "Text color of the chart title text are, in rgba(rvalue,gvalue,bvalue,avalue)",
  "viewsLastDay" : "integer",
  "updaterId" : "string",
  "chartTitleScalar" : "Scale (normally 100) of chart title text size",
  "numFavorites" : "integer",
  "id" : "Unique identifier, also URL slug, of the dashboard",
  "displayQueryParameters" : "Whether the dashboard parameters section is opened by default when the dashboard is shown",
  "defaultTimeWindow" : "Default time window to query charts",
  "displayDescription" : "Whether the dashboard description section is opened by default when the dashboard is shown",
  "defaultEndTime" : "Default end time in milliseconds to query charts",
  "createdEpochMillis" : "integer",
  "systemOwned" : "Whether this dashboard is system-owned and not writeable",
  "eventQuery" : "Event query to run on dashboard charts",
  "updatedEpochMillis" : "integer",
  "displaySectionTableOfContents" : "Whether the \"pills\" quick-linked the sections of the dashboard are displayed by default when the dashboard is shown",
  "orphan" : "boolean",
  "modifyAclAccess" : "Whether the user has modify ACL access to the dashboard.",
  "url" : "Unique identifier, also URL slug, of the dashboard",
  "sections" : [ {
    "sectionFilter" : { },
    "name" : "Name of this section",
    "rows" : [ {
      "charts" : [ {
        "chartAttributes" : { },
        "summarization" : "Summarization strategy for the chart. MEAN is default",
        "chartSettings" : {
          "ymin" : "For x-y scatterplots, min value for Y-axis. Set null for auto",
          "fixedLegendFilterField" : "Statistic to use for determining whether a series is displayed on the fixed legend",
          "numTags" : "For the tabular view, how many point tags to display",
          "timeBasedColoring" : "Fox x-y scatterplots, whether to color more recent points as darker than older points. Default: false",
          "sparklineFillColor" : "For the single stat view, the color of the background fill. Values should be in\"rgba(, , , \" format",
          "y0ScaleSIBy1024" : "Default: false. Whether to scale numerical magnitude labels for left Y-axis by 1024 in the IEC/Binary manner (instead of by 1000 like SI)",
          "showHosts" : "For the tabular view, whether to display sources. Default: true",
          "type" : "Chart Type. 'line' refers to the Line Plot, 'scatter' to the Point Plot, 'stacked-area' to the Stacked Area plot, 'table' to the Tabular View, 'scatterploy-xy' to Scatter Plot, 'markdown-widget' to the Markdown display, and 'sparkline' to the Single Stat view",
          "sparklineValueColorMapValues" : [ "integer" ],
          "showRawValues" : "For the tabular view, whether to display raw values. Default: false",
          "fixedLegendDisplayStats" : [ "string" ],
          "columnTags" : "deprecated",
          "sparklineSize" : "For the single stat view, a misleadingly named property. This determines whether the sparkline of the statistic is displayed in the chart BACKGROUND, BOTTOM, or NONE",
          "windowSize" : "Width, in minutes, of the time window to use for \"last\" windowing",
          "customTags" : [ "string" ],
          "sparklineValueTextMapText" : [ "string" ],
          "sparklineDecimalPrecision" : "For the single stat view, the decimal precision of the displayed number",
          "lineType" : "Plot interpolation type. linear is default",
          "sparklineValueColorMapColors" : [ "string" ],
          "y1UnitAutoscaling" : "Default: false. Whether to automatically adjust magnitude labels and units for the right Y-axis to favor smaller magnitudes and larger units",
          "fixedLegendFilterLimit" : "Number of series to include in the fixed legend",
          "y1Min" : "For plots with multiple Y-axes, min value for right-side Y-axis. Set null for auto",
          "stackType" : "Type of stacked chart (applicable only if chart type is stacked). zero (default) means stacked from y=0. expand means Normalized from 0 to 1. wiggle means Minimize weighted changes. silhouette means to Center the Stream",
          "fixedLegendEnabled" : "Whether to enable a fixed tabular legend adjacent to the chart",
          "sparklineValueColorMapApplyTo" : "For the single stat view, whether to apply dynamic color settings to the displayed TEXT or BACKGROUND",
          "groupBySource" : "For the tabular view, whether to group multi metrics into a single row by a common source. If false, each metric for each source is displayed in its own row. If true, multiple metrics for the same host will be displayed as different columns in the same row",
          "sparklineDisplayVerticalPosition" : "deprecated",
          "sparklineDisplayColor" : "For the single stat view, the color of the displayed text (when not dynamically determined). Values should be in\"rgba(, , , \" format",
          "y1Units" : "For plots with multiple Y-axes, units for right-side Y-axis",
          "invertDynamicLegendHoverControl" : "Whether to disable the display of the floating legend (but reenable it when the ctrl-key is pressed)",
          "y1Max" : "For plots with multiple Y-axes, max value for right-side Y-axis. Set null for auto",
          "fixedLegendUseRawStats" : "If true, the legend uses non-summarized stats instead of summarized",
          "sparklineValueTextMapThresholds" : [ "number" ],
          "sparklineDisplayPostfix" : "For the single stat view, a string to append to the displayed text",
          "sparklineValueColorMapValuesV2" : [ "number" ],
          "sparklineLineColor" : "For the single stat view, the color of the line. Values should be in\"rgba(, , , \" format",
          "y1ScaleSIBy1024" : "Default: false. Whether to scale numerical magnitude labels for right Y-axis by 1024 in the IEC/Binary manner (instead of by 1000 like SI)",
          "sortValuesDescending" : "For the tabular view, whether to display display values in descending order. Default: false",
          "sparklineDisplayValueType" : "For the single stat view, whether to display the name of the query or the value of query",
          "y0UnitAutoscaling" : "Default: false. Whether to automatically adjust magnitude labels and units for the left Y-axis to favor smaller magnitudes and larger units",
          "min" : "Min value of Y-axis. Set to null or leave blank for auto",
          "fixedLegendHideLabel" : "deprecated",
          "xmax" : "For x-y scatterplots, max value for X-axis. Set null for auto",
          "sparklineDisplayPrefix" : "For the single stat view, a string to add before the displayed text",
          "sparklineDisplayHorizontalPosition" : "For the single stat view, the horizontal position of the displayed text",
          "xmin" : "For x-y scatterplots, min value for X-axis. Set null for auto",
          "windowing" : "For the tabular view, whether to use the full time window for the query or the last X minutes",
          "max" : "Max value of Y-axis. Set to null or leave blank for auto",
          "fixedLegendPosition" : "Where the fixed legend should be displayed with respect to the chart",
          "fixedLegendFilterSort" : "Whether to display \"Top\"- or \"Bottom\"-ranked series in the fixed legend",
          "ymax" : "For x-y scatterplots, max value for Y-axis. Set null for auto",
          "sparklineDisplayFontSize" : "For the single stat view, the font size of the displayed text, in percent",
          "showLabels" : "For the tabular view, whether to display labels. Default: true",
          "tagMode" : "For the tabular view, which mode to use to determine which point tags to display",
          "autoColumnTags" : "deprecated",
          "expectedDataSpacing" : "Threshold (in seconds) for time delta between consecutive points in a series above which a dotted line will replace a solid line in line plots. Default: 60s",
          "plainMarkdownContent" : "The Markdown content for a Markdown display, in plain text. Use this field instead of `markdownContent`."
        },
        "sources" : [ {
          "secondaryAxis" : "Determines if this source relates to the right hand Y-axis or not",
          "querybuilderEnabled" : "Whether or not this source line should have the query builder enabled",
          "query" : "Query expression to plot on the chart",
          "name" : "Name of the source",
          "scatterPlotSource" : "For scatter plots, does this query source the X-axis or the Y-axis",
          "querybuilderSerialization" : "Opaque representation of the querybuilder",
          "disabled" : "Whether the source is disabled",
          "sourceDescription" : "A description for the purpose of this source",
          "sourceColor" : "The color used to draw all results from this source (auto if unset)"
        } ],
        "noDefaultEvents" : "Whether to hide events related to the sources in the charts produced. Default false (i.e. shows events)",
        "name" : "Name of the source",
        "description" : "Description of the chart",
        "units" : "String to label the units of the chart on the Y-axis",
        "interpolatePoints" : "Whether to interpolate points in the charts produced. Default: true",
        "includeObsoleteMetrics" : "Whether to show obsolete metrics. Default: false",
        "base" : "If the chart has a log-scale Y-axis, the base for the logarithms"
      } ],
      "heightFactor" : "Scalar for the height of this row. 100 is normal and default. 50 is half height"
    } ]
  } ],
  "dashboardAttributes" : { },
  "tags" : {
    "customerTags" : [ "string" ]
  },
  "numCharts" : "integer",
  "viewsLastMonth" : "integer",
  "deleted" : "boolean",
  "chartTitleBgColor" : "Background color of the chart title text area, in rgba(rvalue,gvalue,bvalue,avalue)",
  "name" : "Name of the dashboard",
  "parameters" : "Deprecated. An obsolete representation of dashboard parameters",
  "favorite" : "boolean",
  "customer" : "id of the customer to which this dashboard belongs",
  "eventFilterType" : "How charts belonging to this dashboard should display events. BYCHART is default if unspecified"
}

$body#

Example Body:
{
"name": "Query Name",
"query": "aliasMetric(ts(~sample.cpu.loadavg.1m), "my.new.metric")",
"minutes": 5,
"additionalInformation": "Additional Info",
"tags": {
"customerTags": [
"derivedMetricTag1"
]
}
}

Type: object

{
  "queryQBEnabled" : "Whether the query was created using the Query Builder. Default false",
  "createUserId" : "string",
  "lastFailedTime" : "The time of the last error encountered when running the query, in epoch millis",
  "pointsScannedAtLastQuery" : "A derived field recording the number of data points scanned when the system last computed the query",
  "creatorId" : "string",
  "updaterId" : "string",
  "queryFailing" : "Whether there was an exception when the query last ran",
  "id" : "string",
  "metricsUsed" : [ "string" ],
  "additionalInformation" : "User-supplied additional explanatory information for the derived metric",
  "hostsUsed" : [ "string" ],
  "lastErrorMessage" : "The last error encountered when running the query",
  "updateUserId" : "The user that last updated this derived metric definition",
  "createdEpochMillis" : "integer",
  "minutes" : "How frequently the query generating the derived metric is run",
  "created" : "When this derived metric was created, in epoch millis",
  "lastQueryTime" : "Time for the query execute, averaged on hourly basis",
  "query" : "A Wavefront query that is evaluated at regular intervals (default 1m).",
  "processRateMinutes" : "The interval between executing the query, in minutes. Defaults to 1 minute",
  "updatedEpochMillis" : "integer",
  "inTrash" : "boolean",
  "tags" : {
    "customerTags" : [ "string" ]
  },
  "deleted" : "boolean",
  "name" : "Required string",
  "queryQBSerialization" : "The special serialization of the Query Builder that corresponds to the query. Applicable only when queryQBEnabled is true",
  "lastProcessedMillis" : "The last time when the derived metric query was run, in epoch millis",
  "updated" : "When the derived metric definition was last updated, in epoch millis",
  "includeObsoleteMetrics" : "Whether to include obsolete metrics in query",
  "status" : [ "string" ]
}

$body#

Example Body:
{
"name": "Event API Example",
"annotations": {
"severity": "info",
"type": "event type",
"details": "description"
},
"tags" : [
"eventTag1"
],
"startTime": 1490000000000,
"endTime": 1490000000001
}

Type: object

{
  "alertTags" : [ "string" ],
  "canClose" : "boolean",
  "summarizedEvents" : "In some event queries, multiple events that occur nearly simultaneously are summarized under a single event. This value specifies the number of events summarized under this one",
  "isEphemeral" : "Whether the event is an artificial event generated by a literal expression or alert backtesting, i.e. not stored in the Wavefront backend",
  "creatorType" : [ "string. Possible values: USER | ALERT | SYSTEM" ],
  "createdEpochMillis" : "integer",
  "hosts" : [ "string" ],
  "creatorId" : "string",
  "annotations" : "A string->string map of additional annotations on the event",
  "isUserEvent" : "Whether this event was created by a user, versus the system. Default: system",
  "updatedEpochMillis" : "integer",
  "tags" : [ "string" ],
  "createdAt" : "integer",
  "updaterId" : "string",
  "name" : "The name of the event. If 'annotations.prettyName' is present, 'name' will be equivalent to that value",
  "runningState" : "string. Possible values: ONGOING | PENDING | ENDED",
  "startTime" : "Start time of the event, in epoch millis. If the JSON value is missing or set to 0, startTime will be set to the current time",
  "canDelete" : "boolean",
  "id" : "string",
  "endTime" : "End time of the event, in epoch millis. Set to startTime + 1 for an instantaneous event",
  "metricsUsed" : [ "string" ],
  "table" : "The customer to which the event belongs",
  "dimensions" : "A string-> map of additional dimension info on the event",
  "updatedAt" : "integer"
}

$body#

Example Body:
{
"name": "External Link API Example",
"template": "https://example.com/",
"description": "External Link Description"
}

Type: object

{
  "template" : "The mustache template for this link. This template must expand to a full URL, including scheme, origin, etc",
  "updaterId" : "string",
  "createdEpochMillis" : "integer",
  "name" : "Name of the external link. Will be displayed in context (right-click) menus on charts",
  "creatorId" : "string",
  "description" : "Human-readable description for this external link",
  "pointTagFilterRegexes" : "Controls whether a link displayed in the context menu of a highlighted series. This is a map from string to regular expression. The highlighted series must contain point tags whose keys are present in the keys of this map and whose values match the regular expressions associated with those keys in order for the link to be displayed",
  "updatedEpochMillis" : "integer",
  "id" : "string",
  "metricFilterRegex" : "Controls whether a link displayed in the context menu of a highlighted series. If present, the metric name of the highlighted series must match this regular expression in order for the link to be displayed",
  "sourceFilterRegex" : "Controls whether a link displayed in the context menu of a highlighted series. If present, the source name of the highlighted series must match this regular expression in order for the link to be displayed"
}

$body#

Example Body:
{
"name": "Ingestion policy name",
"description": "Ingestion policy description"
}

Type: object

{
  "sampledServiceAccounts" : [ "string" ],
  "lastUpdatedAccountId" : "The account that updated this ingestion policy last time",
  "sampledUserAccounts" : [ "string" ],
  "lastUpdatedMs" : "The last time when the ingestion policy is updated, in epoch milliseconds",
  "name" : "The name of the ingestion policy",
  "description" : "The description of the ingestion policy",
  "id" : "The unique ID for the ingestion policy",
  "userAccountCount" : "Total number of user accounts that are linked to the ingestion policy",
  "serviceAccountCount" : "Total number of service accounts that are linked to the ingestion policy",
  "customer" : "ID of the customer to which the ingestion policy belongs"
}

$body#

Example Body:
{
"reason": "MW Reason",
"title": "MW Title",
"startTimeInSeconds": 1483228800,
"endTimeInSeconds": 1483232400,
"relevantCustomerTags": [
"alertId1"
],
"relevantHostTags": [
"sourceTag1"
]
}

Type: object

{
  "reason" : "The purpose of this maintenance window",
  "endTimeInSeconds" : "The time in epoch seconds when this maintenance window will end",
  "createdEpochMillis" : "integer",
  "hostTagGroupHostNamesGroupAnded" : "If true, a source/host must be in 'relevantHostNames' and have tags matching the specification formed by 'relevantHostTags' and 'relevantHostTagsAnded' in order for this maintenance window to apply. If false, a source/host must either be in 'relevantHostNames' or match 'relevantHostTags' and 'relevantHostTagsAnded'. Default: false",
  "creatorId" : "string",
  "updatedEpochMillis" : "integer",
  "sortAttr" : "Numeric value used in default sorting",
  "title" : "Title of this maintenance window",
  "relevantHostTags" : [ "string" ],
  "relevantCustomerTags" : [ "string" ],
  "startTimeInSeconds" : "The time in epoch seconds when this maintenance window will start",
  "updaterId" : "string",
  "relevantHostTagsAnded" : "Whether to AND source/host tags listed in relevantHostTags. If true, a source/host must contain all tags in order for the maintenance window to apply. If false, the tags are OR'ed, and a source/host must contain one of the tags. Default: false",
  "customerId" : "string",
  "eventName" : "The name of an event associated with the creation/update of this maintenance window",
  "runningState" : "string. Possible values: ONGOING | PENDING | ENDED",
  "id" : "string",
  "relevantHostNames" : [ "string" ]
}

$body#

Example Body:
{
"description": "Notificant Description",
"template": "POST Body -- Mustache syntax",
"title": "Email title",
"triggers": [
"ALERT_OPENED"
],
"method": "EMAIL",
"recipient": "value@example.com",
"emailSubject": "Email subject cannot contain new line"
}

Type: object

{
  "template" : "A mustache template that will form the body of the POST request, email and summary of the PagerDuty.",
  "method" : "The notification method used for notification target.",
  "createdEpochMillis" : "integer",
  "creatorId" : "string",
  "description" : "Description",
  "updatedEpochMillis" : "integer",
  "title" : "Title",
  "triggers" : [ "string. Possible values: ALERT_OPENED | ALERT_UPDATED | ALERT_RESOLVED | ALERT_MAINTENANCE | ALERT_SNOOZED | ALERT_INVALID | ALERT_NO_LONGER_INVALID | ALERT_TESTING | ALERT_RETRIGGERED | ALERT_NO_DATA | ALERT_NO_DATA_RESOLVED | ALERT_NO_DATA_MAINTENANCE | ALERT_SEVERITY_UPDATE" ],
  "emailSubject" : "The subject title of an email notification target",
  "routes" : [ {
    "filter" : "String that filters the route. Space delimited. Currently only allows single key value pair. filter: env* prod*",
    "method" : "The end point for the alert route.EMAIL: email address. PAGERDUTY: PagerDuty routing Key. WEBHOOK: URL end point",
    "target" : "The end point for the notification target.EMAIL: email address. PAGERDUTY: PagerDuty routing Key. WEBHOOK: URL end point"
  } ],
  "isHtmlContent" : "Determine whether the email alert target content is sent as html or text.",
  "customHttpHeaders" : "A string->string map specifying the custom HTTP header key / value pairs that will be sent in the requests of this web hook",
  "updaterId" : "string",
  "customerId" : "string",
  "recipient" : "The end point for the notification target.EMAIL: email address. PAGERDUTY: PagerDuty routing Key. WEBHOOK: URL end point",
  "id" : "string",
  "contentType" : "The value of the Content-Type header of the webhook POST request."
}

$body#

Example Body:
{
"emailAddress": "user@example.com",
"groups": [
"user_management"
],
"userGroups": [
"8b23136b-ecd2-4cb5-8c92-62477dcc4090"
],
"ingestionPolicyId": "ingestionPolicyId",
"roles": [
"Role"
]
}

Type: object

{
  "userGroups" : [ "string" ],
  "emailAddress" : "The (unique) identifier of the user to create. Must be a valid email address",
  "roles" : [ "string" ],
  "groups" : [ "string" ],
  "ingestionPolicyId" : "The identifier of the ingestion policy linked with user."
}

sendEmail#

Whether to send email notification to the user, if created. Default: false

Type: boolean

$body#

Example Body:
{
"emailAddress": "user@example.com",
"groups": [
"user_management"
],
"userGroups": [
"8b23136b-ecd2-4cb5-8c92-62477dcc4090"
],
"ingestionPolicyId": "ingestionPolicyId",
"roles": [
"Role"
]
}

Type: object

{
  "userGroups" : [ "string" ],
  "emailAddress" : "The (unique) identifier of the user to create. Must be a valid email address",
  "roles" : [ "string" ],
  "groups" : [ "string" ],
  "ingestionPolicyId" : "The identifier of the ingestion policy linked with user."
}

sendEmail#

Whether to send email notification to the user, if created. Default: false

Type: boolean

$body#

Example Body:
{
"name": "Role name",
"permissions": [
"permission1",
"permission2",
"permission3"
],
"description": "Role description"
}

Type: object

{
  "sampleLinkedAccounts" : [ "string" ],
  "lastUpdatedAccountId" : "The account that updated this role last time",
  "linkedGroupsCount" : "Total number of groups that are linked to the role",
  "createdEpochMillis" : "integer",
  "permissions" : [ "string" ],
  "lastUpdatedMs" : "The last time when the role is updated, in epoch milliseconds",
  "name" : "The name of the role",
  "sampleLinkedGroups" : [ {
    "userCount" : "Total number of users that are members of the user group",
    "permissions" : [ "string" ],
    "roles" : [ "RoleDTO" ],
    "name" : "Name of the user group",
    "description" : "The description of the user group",
    "id" : "Unique ID for the user group",
    "users" : [ "string" ],
    "properties" : {
      "nameEditable" : "boolean",
      "usersEditable" : "boolean",
      "permissionsEditable" : "boolean",
      "rolesEditable" : "boolean"
    },
    "customer" : "ID of the customer to which the user group belongs"
  } ],
  "description" : "The description of the role",
  "id" : "The unique identifier of the role",
  "linkedAccountsCount" : "Total number of accounts that are linked to the role",
  "customer" : "The id of the customer to which the role belongs"
}

$body#

Example Body:
{
"query": {
"foo": "{"searchTerms":[{"type":"freetext","value":"foo"}]}"
},
"entityType": "DASHBOARD"
}

Type: object

{
  "updaterId" : "string",
  "createdEpochMillis" : "integer",
  "entityType" : "The Wavefront entity type over which to search",
  "query" : "The map corresponding to the search query. The key is the name of the query, and the value is a JSON representation of the query",
  "creatorId" : "string",
  "updatedEpochMillis" : "integer",
  "id" : "string",
  "userId" : "The user for whom this search is saved"
}

$body#

Wavefront service account entity for write requests.

Type: object

{
  "identifier" : "The unique identifier for a service account.",
  "userGroups" : [ "string" ],
  "roles" : [ "string" ],
  "active" : "The current state of the service account.",
  "description" : "The description of the service account to be created.",
  "groups" : [ "string" ],
  "tokens" : [ "string" ],
  "ingestionPolicyId" : "The identifier of the ingestion policy linked with service account."
}

$body#

Example Body:
{
"sourceName": "source.name",
"tags": {"sourceTag1": true},
"description": "Source Description"
}

Type: object

{
  "hidden" : "A derived field denoting whether this source has been hidden (e.g. excluding it from query autocomplete among other things)",
  "updaterId" : "string",
  "createdEpochMillis" : "integer",
  "creatorId" : "string",
  "description" : "Description of this source",
  "updatedEpochMillis" : "integer",
  "id" : "id of this source, must be exactly equivalent to 'sourceName'",
  "sourceName" : "The name of the source, usually set by ingested telemetry",
  "markedNewEpochMillis" : "Epoch Millis when this source was marked as ~status.new",
  "tags" : "A Map (String -> boolean) Representing the source tags associated with this source. To create a tag, set it as a KEY in this map, with associated value equal to true"
}

$body#

Example Body:
{
"name": "UserGroup name",
"permissions": [
"permission1",
"permission2",
"permission3"
],
"roleIDs": [
"role1",
"role2",
"role3"
],
"description": "UserGroup description"
}

Type: object

{
  "roleIDs" : [ "string" ],
  "createdEpochMillis" : "integer",
  "permissions" : [ "string" ],
  "name" : "The name of the user group",
  "description" : "The description of the user group",
  "id" : "The unique identifier of the user group",
  "customer" : "The id of the customer to which the user group belongs"
}

$body#

Example Body:
{
"description": "WebHook Description",
"template": "POST Body -- Mustache syntax",
"title": "WebHook Title",
"triggers": [
"ALERT_OPENED"
],
"recipient": "http://example.com",
"customHttpHeaders": {},
"contentType": "text/plain"
}

Type: object

{
  "template" : "A mustache template that will form the body of the POST request, email and summary of the PagerDuty.",
  "method" : "The notification method used for notification target.",
  "createdEpochMillis" : "integer",
  "creatorId" : "string",
  "description" : "Description",
  "updatedEpochMillis" : "integer",
  "title" : "Title",
  "triggers" : [ "string. Possible values: ALERT_OPENED | ALERT_UPDATED | ALERT_RESOLVED | ALERT_MAINTENANCE | ALERT_SNOOZED | ALERT_INVALID | ALERT_NO_LONGER_INVALID | ALERT_TESTING | ALERT_RETRIGGERED | ALERT_NO_DATA | ALERT_NO_DATA_RESOLVED | ALERT_NO_DATA_MAINTENANCE | ALERT_SEVERITY_UPDATE" ],
  "emailSubject" : "The subject title of an email notification target",
  "routes" : [ {
    "filter" : "String that filters the route. Space delimited. Currently only allows single key value pair. filter: env* prod*",
    "method" : "The end point for the alert route.EMAIL: email address. PAGERDUTY: PagerDuty routing Key. WEBHOOK: URL end point",
    "target" : "The end point for the notification target.EMAIL: email address. PAGERDUTY: PagerDuty routing Key. WEBHOOK: URL end point"
  } ],
  "isHtmlContent" : "Determine whether the email alert target content is sent as html or text.",
  "customHttpHeaders" : "A string->string map specifying the custom HTTP header key / value pairs that will be sent in the requests of this web hook",
  "updaterId" : "string",
  "customerId" : "string",
  "recipient" : "The end point for the notification target.EMAIL: email address. PAGERDUTY: PagerDuty routing Key. WEBHOOK: URL end point",
  "id" : "string",
  "contentType" : "The value of the Content-Type header of the webhook POST request."
}

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

skipTrash#

Type: boolean

id (required)#

Type: string

id (required)#

Type: string

skipTrash#

Type: boolean

id (required)#

Type: string

skipTrash#

Type: boolean

id (required)#

Type: string

skipTrash#

Type: boolean

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

$body#

list of accounts' identifiers to be deleted

Type: array

[ "string" ]

$body#

identifiers of list of users which should be deleted

Type: array

[ "string" ]

id (required)#

Type: string

id (required)#

Type: string

skipTrash#

Type: boolean

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

token (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

startTime (required)#

start time in epoch seconds

Type: integer

endTime#

end time in epoch seconds, null to use now

Type: integer

id (required)#

Type: string

id (required)#

Type: string

$body#

Wavefront user api token entity for update requests

Type: object

{
  "lastUsed" : "The last time this token was used",
  "tokenID" : "The identifier of the user API token",
  "tokenName" : "The name of the user API token"
}

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id#

Type: array

[ "string" ]

id (required)#

Type: string

id (required)#

id of an event of type alert or alert-detail, used to lookup the particular alert firing

Type: string

alertId (required)#

Type: string

earliestStartTimeEpochMillis#

Type: integer

latestStartTimeEpochMillis#

Type: integer

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

version (required)#

Type: integer

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id#

Type: array

[ "string" ]

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

version (required)#

Type: integer

id (required)#

Type: string

id (required)#

Type: string

version (required)#

Type: integer

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

hasContent#

Type: boolean

returnContent#

Type: boolean

id (required)#

Type: string

refresh#

Type: boolean

id (required)#

Type: string

m (required)#

Metric name

Type: string

c#

cursor value to continue if the number of results exceeds 1000

Type: string

h#

glob pattern for sources to include in the query result

Type: array

[ "string" ]

l#

limit

Type: integer

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

isOverlapped#

Type: boolean

renderingMethod#

Type: string

Potential values: HOST, METRIC, SIMILARITY

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

permission (required)#

Permission to grant to the account. Please note that'host_tag_management' is the equivalent of the 'Source Tag Management' permission

Type: string

Potential values: agent_management, alerts_management, dashboard_management, embedded_charts, events_management, external_links_management, host_tag_management, metrics_management, user_management

permission (required)#

Permission to grant to the accounts. Please note that 'host_tag_management' is the equivalent of the 'Source Tag Management' permission

Type: string

Potential values: agent_management, alerts_management, dashboard_management, embedded_charts, events_management, external_links_management, host_tag_management, metrics_management, user_management

$body#

List of accounts the specified permission to be granted to

Type: array

[ "string" ]

permission (required)#

Permission to grant to role(s).

Type: string

$body#

List of roles.

Type: array

[ "string" ]

permission (required)#

Permission to grant to the users. Please note that 'host_tag_management' is the equivalent of the 'Source Tag Management' permission

Type: string

Potential values: agent_management, alerts_management, dashboard_management, embedded_charts, events_management, external_links_management, host_tag_management, metrics_management, user_management

$body#

List of users which should be granted by specified permission

Type: array

[ "string" ]

id (required)#

Type: string

$body#

Type: object

{
  "group" : "Permission group to grant to the account. Please note that 'host_tag_management' is the equivalent of the 'Source Tag Management' permission"
}

id (required)#

Type: integer

id (required)#

Type: string

$body#

Install Alerts

Type: object

{
  "target" : "string"
}

id (required)#

Type: string

$body#

Example Body:
[
{
"emailAddress": "user@example.com",
"groups": [
"user_management"
],
"userGroups": [
"8b23136b-ecd2-4cb5-8c92-62477dcc4090"
],
"ingestionPolicyId": "ingestionPolicyId",
"roles": [
"Role"
]
}
]

Type: array

[ {
  "userGroups" : [ "string" ],
  "emailAddress" : "The (unique) identifier of the user to create. Must be a valid email address",
  "roles" : [ "string" ],
  "groups" : [ "string" ],
  "ingestionPolicyId" : "The identifier of the ingestion policy linked with user."
} ]

$body#

Example Body:
[
{
"emailAddress": "user@example.com",
"groups": [
"user_management"
],
"userGroups": [
"8b23136b-ecd2-4cb5-8c92-62477dcc4090"
],
"ingestionPolicyId": "ingestionPolicyId",
"roles": [
"Role"
]
}
]

Type: array

[ {
  "userGroups" : [ "string" ],
  "emailAddress" : "The (unique) identifier of the user to create. Must be a valid email address",
  "roles" : [ "string" ],
  "groups" : [ "string" ],
  "ingestionPolicyId" : "The identifier of the ingestion policy linked with user."
} ]

entitytype (required)#

Type: string

Potential values: DASHBOARD, ALERT, MAINTENANCE_WINDOW, NOTIFICANT, EVENT, SOURCE, EXTERNAL_LINK, AGENT, CLOUD_INTEGRATION, USER, USER_GROUP, SERVICE_ACCOUNT, INGESTION_POLICY, ROLE

cursor#

Type: string

earliestStartTimeEpochMillis#

Type: integer

latestStartTimeEpochMillis#

Type: integer

cursor#

Type: string

g (required)#

the granularity of the points returned

Type: string

Potential values: d, h, m, s

q (required)#

the query expression to execute

Type: string

s (required)#

the start time of the query window in epoch milliseconds

Type: string

autoEvents#

whether events for sources included in the query will be automatically returned by the query

Type: boolean

cached#

whether the query cache is used, defaults to true

Type: boolean

dimensionTuples#

Type: array

[ "string" ]

e#

the end time of the query window in epoch milliseconds (null to use now)

Type: string

i#

whether series with only points that are outside of the query window will be returned (defaults to true)

Type: boolean

includeObsoleteMetrics#

include metrics that have not been reporting recently, defaults to false

Type: boolean

listMode#

retrieve events more optimally displayed for a list

Type: boolean

n#

name used to identify the query

Type: string

p#

the approximate maximum number of points to return (may not limit number of points exactly)

Type: string

sorted#

sorts the output so that returned series are in order, defaults to false

Type: boolean

strict#

do not return points outside the query window [s;e), defaults to false

Type: boolean

summarization#

summarization strategy to use when bucketing points together

Type: string

Potential values: MEAN, MEDIAN, MIN, MAX, SUM, COUNT, LAST, FIRST

useRawQK#

Type: boolean

view#

view of the query result, metric or histogram, defaults to metric

Type: string

Potential values: METRIC, HISTOGRAM

metric (required)#

metric to query ingested points for (cannot contain wildcards)

Type: string

endTime#

end time in epoch milliseconds (cannot be more than a day in the past) null to use now

Type: integer

host#

host to query ingested points for (cannot contain wildcards). host or source is equivalent, only one should be used.

Type: string

source#

source to query ingested points for (cannot contain wildcards). host or source is equivalent, only one should be used.

Type: string

startTime#

start time in epoch milliseconds (cannot be more than a day in the past) null to use an hour before endTime

Type: integer

id (required)#

Type: string

$body#

The list of roles that should be removed from the account

Type: array

[ "string" ]

id (required)#

Type: string

$body#

The list of user groups that should be removed from the account

Type: array

[ "string" ]

$body#

Type: array

[ {
  "viewAcl" : [ "string" ],
  "modifyAcl" : [ "string" ],
  "entityId" : "The entity Id"
} ]

id (required)#

Type: string

tagValue (required)#

Type: string

id (required)#

Type: string

$body#

List of users and user groups thatshould be removed from role

Type: array

[ "string" ]

$body#

Type: array

[ {
  "viewAcl" : [ "string" ],
  "modifyAcl" : [ "string" ],
  "entityId" : "The entity Id"
} ]

id (required)#

Type: string

tagValue (required)#

Type: string

id (required)#

Type: string

id (required)#

Type: string

tagValue (required)#

Type: string

$body#

identifiers of list of accounts from which ingestion policies should be removed

Type: array

[ "string" ]

id (required)#

Type: string

$body#

List of roles that should be removed from user group

Type: array

[ "string" ]

id (required)#

Type: string

tagValue (required)#

Type: string

id (required)#

Type: string

tagValue (required)#

Type: string

id (required)#

Type: string

$body#

The list of user groups that should be removed from the account

Type: array

[ "string" ]

id (required)#

Type: string

$body#

List of users that should be removed from user group

Type: array

[ "string" ]

$body#

Data to be ingested, in the specified format. See https://docs.wavefront.com/direct_ingestion.html for more detail on how to format the data. Example in "wavefront" format:
test.metric 100 source=test.source
which ingests a time series point with metric name "test.metric", source name "test.source", and value of 100 with timestamp of now.

Type: string

f#

Format of data to be ingested

Type: string

Potential values: wavefront, histogram, trace

id (required)#

Type: string

permission (required)#

Type: string

permission (required)#

Permission to revoke from the accounts. Please note that 'host_tag_management' is the equivalent of the 'Source Tag Management' permission

Type: string

Potential values: agent_management, alerts_management, dashboard_management, embedded_charts, events_management, external_links_management, host_tag_management, metrics_management, user_management

$body#

List of accounts the specified permission to be revoked from

Type: array

[ "string" ]

permission (required)#

Permission to revoke from role(s).

Type: string

$body#

List of roles.

Type: array

[ "string" ]

permission (required)#

Permission to revoke from the accounts. Please note that 'host_tag_management' is the equivalent of the 'Source Tag Management' permission

Type: string

Potential values: agent_management, alerts_management, dashboard_management, embedded_charts, events_management, external_links_management, host_tag_management, metrics_management, user_management

$body#

List of users or service accounts which should be revoked by specified permission

Type: array

[ "string" ]

id (required)#

Type: string

$body#

Type: object

{
  "group" : "string"
}

$body#

Type: object

{
  "offset" : "The number of results to skip before returning values. Default: 0",
  "query" : [ {
    "negated" : "The flag to create a NOT operation. Default: false",
    "values" : [ "string" ],
    "matchingMethod" : "The method by which search matching is performed. Default: CONTAINS",
    "value" : "The entity facet value for which to search. Either value or values field is required. If both are set, values takes precedence.",
    "key" : "The entity facet (key) by which to search. Valid keys are any property keys returned by the JSON representation of the entity. Examples are 'creatorId', 'name', etc. The following special key keywords are also valid: 'tags' performs a search on entity tags, 'tagpath' performs a hierarchical search on tags, with periods (.) as path level separators. 'freetext' performs a free text search across many fields of the entity"
  } ],
  "limit" : "The number of results to return. Default: 100",
  "sort" : {
    "default" : "Whether this sort requests the default ranking order. Ascending/descending does not matter if this attribute is true.",
    "field" : "The facet by which to sort",
    "ascending" : "Whether to sort ascending. If undefined, sorting is not guaranteed"
  }
}

facet (required)#

Type: string

$body#

Type: object

{
  "offset" : "The number of results to skip before returning values. Default: 0",
  "query" : [ {
    "negated" : "The flag to create a NOT operation. Default: false",
    "values" : [ "string" ],
    "matchingMethod" : "The method by which search matching is performed. Default: CONTAINS",
    "value" : "The entity facet value for which to search. Either value or values field is required. If both are set, values takes precedence.",
    "key" : "The entity facet (key) by which to search. Valid keys are any property keys returned by the JSON representation of the entity. Examples are 'creatorId', 'name', etc. The following special key keywords are also valid: 'tags' performs a search on entity tags, 'tagpath' performs a hierarchical search on tags, with periods (.) as path level separators. 'freetext' performs a free text search across many fields of the entity"
  } ],
  "limit" : "The number of results to return. Default: 100",
  "facetQuery" : "A string against which facet results are compared. If the facet result CONTAINs, STARTSWITH, or is an EXACT match for this value, as specified by facetQueryMatchingMethod, then it is returned.",
  "facetQueryMatchingMethod" : "The matching method used to filter when 'facetQuery' is used. Defaults to CONTAINS."
}

$body#

Type: object

{
  "query" : [ {
    "negated" : "The flag to create a NOT operation. Default: false",
    "values" : [ "string" ],
    "matchingMethod" : "The method by which search matching is performed. Default: CONTAINS",
    "value" : "The entity facet value for which to search. Either value or values field is required. If both are set, values takes precedence.",
    "key" : "The entity facet (key) by which to search. Valid keys are any property keys returned by the JSON representation of the entity. Examples are 'creatorId', 'name', etc. The following special key keywords are also valid: 'tags' performs a search on entity tags, 'tagpath' performs a hierarchical search on tags, with periods (.) as path level separators. 'freetext' performs a free text search across many fields of the entity"
  } ],
  "limit" : "The number of results to return. Default 100",
  "facetQuery" : "A string against which facet results are compared. If the facet result either CONTAINs, STARTSWITH, or is an EXACT match for this value, as specified by facetQueryMatchingMethod, then it is returned",
  "facetQueryMatchingMethod" : "The matching method used to filter when 'facetQuery' is used. Defaults to CONTAINS.",
  "facets" : [ "string" ]
}

$body#

Type: object

{
  "offset" : "The number of results to skip before returning values. Default: 0",
  "query" : [ {
    "negated" : "The flag to create a NOT operation. Default: false",
    "values" : [ "string" ],
    "matchingMethod" : "The method by which search matching is performed. Default: CONTAINS",
    "value" : "The entity facet value for which to search. Either value or values field is required. If both are set, values takes precedence.",
    "key" : "The entity facet (key) by which to search. Valid keys are any property keys returned by the JSON representation of the entity. Examples are 'creatorId', 'name', etc. The following special key keywords are also valid: 'tags' performs a search on entity tags, 'tagpath' performs a hierarchical search on tags, with periods (.) as path level separators. 'freetext' performs a free text search across many fields of the entity"
  } ],
  "limit" : "The number of results to return. Default: 100",
  "sort" : {
    "default" : "Whether this sort requests the default ranking order. Ascending/descending does not matter if this attribute is true.",
    "field" : "The facet by which to sort",
    "ascending" : "Whether to sort ascending. If undefined, sorting is not guaranteed"
  }
}

facet (required)#

Type: string

$body#

Type: object

{
  "offset" : "The number of results to skip before returning values. Default: 0",
  "query" : [ {
    "negated" : "The flag to create a NOT operation. Default: false",
    "values" : [ "string" ],
    "matchingMethod" : "The method by which search matching is performed. Default: CONTAINS",
    "value" : "The entity facet value for which to search. Either value or values field is required. If both are set, values takes precedence.",
    "key" : "The entity facet (key) by which to search. Valid keys are any property keys returned by the JSON representation of the entity. Examples are 'creatorId', 'name', etc. The following special key keywords are also valid: 'tags' performs a search on entity tags, 'tagpath' performs a hierarchical search on tags, with periods (.) as path level separators. 'freetext' performs a free text search across many fields of the entity"
  } ],
  "limit" : "The number of results to return. Default: 100",
  "facetQuery" : "A string against which facet results are compared. If the facet result CONTAINs, STARTSWITH, or is an EXACT match for this value, as specified by facetQueryMatchingMethod, then it is returned.",
  "facetQueryMatchingMethod" : "The matching method used to filter when 'facetQuery' is used. Defaults to CONTAINS."
}

$body#

Type: object

{
  "query" : [ {
    "negated" : "The flag to create a NOT operation. Default: false",
    "values" : [ "string" ],
    "matchingMethod" : "The method by which search matching is performed. Default: CONTAINS",
    "value" : "The entity facet value for which to search. Either value or values field is required. If both are set, values takes precedence.",
    "key" : "The entity facet (key) by which to search. Valid keys are any property keys returned by the JSON representation of the entity. Examples are 'creatorId', 'name', etc. The following special key keywords are also valid: 'tags' performs a search on entity tags, 'tagpath' performs a hierarchical search on tags, with periods (.) as path level separators. 'freetext' performs a free text search across many fields of the entity"
  } ],
  "limit" : "The number of results to return. Default 100",
  "facetQuery" : "A string against which facet results are compared. If the facet result either CONTAINs, STARTSWITH, or is an EXACT match for this value, as specified by facetQueryMatchingMethod, then it is returned",
  "facetQueryMatchingMethod" : "The matching method used to filter when 'facetQuery' is used. Defaults to CONTAINS.",
  "facets" : [ "string" ]
}

$body#

Type: object

{
  "offset" : "The number of results to skip before returning values. Default: 0",
  "query" : [ {
    "negated" : "The flag to create a NOT operation. Default: false",
    "values" : [ "string" ],
    "matchingMethod" : "The method by which search matching is performed. Default: CONTAINS",
    "value" : "The entity facet value for which to search. Either value or values field is required. If both are set, values takes precedence.",
    "key" : "The entity facet (key) by which to search. Valid keys are any property keys returned by the JSON representation of the entity. Examples are 'creatorId', 'name', etc. The following special key keywords are also valid: 'tags' performs a search on entity tags, 'tagpath' performs a hierarchical search on tags, with periods (.) as path level separators. 'freetext' performs a free text search across many fields of the entity"
  } ],
  "limit" : "The number of results to return. Default: 100",
  "sort" : {
    "default" : "Whether this sort requests the default ranking order. Ascending/descending does not matter if this attribute is true.",
    "field" : "The facet by which to sort",
    "ascending" : "Whether to sort ascending. If undefined, sorting is not guaranteed"
  }
}

facet (required)#

Type: string

$body#

Type: object

{
  "offset" : "The number of results to skip before returning values. Default: 0",
  "query" : [ {
    "negated" : "The flag to create a NOT operation. Default: false",
    "values" : [ "string" ],
    "matchingMethod" : "The method by which search matching is performed. Default: CONTAINS",
    "value" : "The entity facet value for which to search. Either value or values field is required. If both are set, values takes precedence.",
    "key" : "The entity facet (key) by which to search. Valid keys are any property keys returned by the JSON representation of the entity. Examples are 'creatorId', 'name', etc. The following special key keywords are also valid: 'tags' performs a search on entity tags, 'tagpath' performs a hierarchical search on tags, with periods (.) as path level separators. 'freetext' performs a free text search across many fields of the entity"
  } ],
  "limit" : "The number of results to return. Default: 100",
  "facetQuery" : "A string against which facet results are compared. If the facet result CONTAINs, STARTSWITH, or is an EXACT match for this value, as specified by facetQueryMatchingMethod, then it is returned.",
  "facetQueryMatchingMethod" : "The matching method used to filter when 'facetQuery' is used. Defaults to CONTAINS."
}

$body#

Type: object

{
  "query" : [ {
    "negated" : "The flag to create a NOT operation. Default: false",
    "values" : [ "string" ],
    "matchingMethod" : "The method by which search matching is performed. Default: CONTAINS",
    "value" : "The entity facet value for which to search. Either value or values field is required. If both are set, values takes precedence.",
    "key" : "The entity facet (key) by which to search. Valid keys are any property keys returned by the JSON representation of the entity. Examples are 'creatorId', 'name', etc. The following special key keywords are also valid: 'tags' performs a search on entity tags, 'tagpath' performs a hierarchical search on tags, with periods (.) as path level separators. 'freetext' performs a free text search across many fields of the entity"
  } ],
  "limit" : "The number of results to return. Default 100",
  "facetQuery" : "A string against which facet results are compared. If the facet result either CONTAINs, STARTSWITH, or is an EXACT match for this value, as specified by facetQueryMatchingMethod, then it is returned",
  "facetQueryMatchingMethod" : "The matching method used to filter when 'facetQuery' is used. Defaults to CONTAINS.",
  "facets" : [ "string" ]
}

$body#

Type: object

{
  "offset" : "The number of results to skip before returning values. Default: 0",
  "query" : [ {
    "negated" : "The flag to create a NOT operation. Default: false",
    "values" : [ "string" ],
    "matchingMethod" : "The method by which search matching is performed. Default: CONTAINS",
    "value" : "The entity facet value for which to search. Either value or values field is required. If both are set, values takes precedence.",
    "key" : "The entity facet (key) by which to search. Valid keys are any property keys returned by the JSON representation of the entity. Examples are 'creatorId', 'name', etc. The following special key keywords are also valid: 'tags' performs a search on entity tags, 'tagpath' performs a hierarchical search on tags, with periods (.) as path level separators. 'freetext' performs a free text search across many fields of the entity"
  } ],
  "limit" : "The number of results to return. Default: 100",
  "sort" : {
    "default" : "Whether this sort requests the default ranking order. Ascending/descending does not matter if this attribute is true.",
    "field" : "The facet by which to sort",
    "ascending" : "Whether to sort ascending. If undefined, sorting is not guaranteed"
  }
}

facet (required)#

Type: string

$body#

Type: object

{
  "offset" : "The number of results to skip before returning values. Default: 0",
  "query" : [ {
    "negated" : "The flag to create a NOT operation. Default: false",
    "values" : [ "string" ],
    "matchingMethod" : "The method by which search matching is performed. Default: CONTAINS",
    "value" : "The entity facet value for which to search. Either value or values field is required. If both are set, values takes precedence.",
    "key" : "The entity facet (key) by which to search. Valid keys are any property keys returned by the JSON representation of the entity. Examples are 'creatorId', 'name', etc. The following special key keywords are also valid: 'tags' performs a search on entity tags, 'tagpath' performs a hierarchical search on tags, with periods (.) as path level separators. 'freetext' performs a free text search across many fields of the entity"
  } ],
  "limit" : "The number of results to return. Default: 100",
  "facetQuery" : "A string against which facet results are compared. If the facet result CONTAINs, STARTSWITH, or is an EXACT match for this value, as specified by facetQueryMatchingMethod, then it is returned.",
  "facetQueryMatchingMethod" : "The matching method used to filter when 'facetQuery' is used. Defaults to CONTAINS."
}

$body#

Type: object

{
  "query" : [ {
    "negated" : "The flag to create a NOT operation. Default: false",
    "values" : [ "string" ],
    "matchingMethod" : "The method by which search matching is performed. Default: CONTAINS",
    "value" : "The entity facet value for which to search. Either value or values field is required. If both are set, values takes precedence.",
    "key" : "The entity facet (key) by which to search. Valid keys are any property keys returned by the JSON representation of the entity. Examples are 'creatorId', 'name', etc. The following special key keywords are also valid: 'tags' performs a search on entity tags, 'tagpath' performs a hierarchical search on tags, with periods (.) as path level separators. 'freetext' performs a free text search across many fields of the entity"
  } ],
  "limit" : "The number of results to return. Default 100",
  "facetQuery" : "A string against which facet results are compared. If the facet result either CONTAINs, STARTSWITH, or is an EXACT match for this value, as specified by facetQueryMatchingMethod, then it is returned",
  "facetQueryMatchingMethod" : "The matching method used to filter when 'facetQuery' is used. Defaults to CONTAINS.",
  "facets" : [ "string" ]
}

$body#

Type: object

{
  "offset" : "The number of results to skip before returning values. Default: 0",
  "query" : [ {
    "negated" : "The flag to create a NOT operation. Default: false",
    "values" : [ "string" ],
    "matchingMethod" : "The method by which search matching is performed. Default: CONTAINS",
    "value" : "The entity facet value for which to search. Either value or values field is required. If both are set, values takes precedence.",
    "key" : "The entity facet (key) by which to search. Valid keys are any property keys returned by the JSON representation of the entity. Examples are 'creatorId', 'name', etc. The following special key keywords are also valid: 'tags' performs a search on entity tags, 'tagpath' performs a hierarchical search on tags, with periods (.) as path level separators. 'freetext' performs a free text search across many fields of the entity"
  } ],
  "limit" : "The number of results to return. Default: 100",
  "sort" : {
    "default" : "Whether this sort requests the default ranking order. Ascending/descending does not matter if this attribute is true.",
    "field" : "The facet by which to sort",
    "ascending" : "Whether to sort ascending. If undefined, sorting is not guaranteed"
  }
}

facet (required)#

Type: string

$body#

Type: object

{
  "offset" : "The number of results to skip before returning values. Default: 0",
  "query" : [ {
    "negated" : "The flag to create a NOT operation. Default: false",
    "values" : [ "string" ],
    "matchingMethod" : "The method by which search matching is performed. Default: CONTAINS",
    "value" : "The entity facet value for which to search. Either value or values field is required. If both are set, values takes precedence.",
    "key" : "The entity facet (key) by which to search. Valid keys are any property keys returned by the JSON representation of the entity. Examples are 'creatorId', 'name', etc. The following special key keywords are also valid: 'tags' performs a search on entity tags, 'tagpath' performs a hierarchical search on tags, with periods (.) as path level separators. 'freetext' performs a free text search across many fields of the entity"
  } ],
  "limit" : "The number of results to return. Default: 100",
  "facetQuery" : "A string against which facet results are compared. If the facet result CONTAINs, STARTSWITH, or is an EXACT match for this value, as specified by facetQueryMatchingMethod, then it is returned.",
  "facetQueryMatchingMethod" : "The matching method used to filter when 'facetQuery' is used. Defaults to CONTAINS."
}

$body#

Type: object

{
  "query" : [ {
    "negated" : "The flag to create a NOT operation. Default: false",
    "values" : [ "string" ],
    "matchingMethod" : "The method by which search matching is performed. Default: CONTAINS",
    "value" : "The entity facet value for which to search. Either value or values field is required. If both are set, values takes precedence.",
    "key" : "The entity facet (key) by which to search. Valid keys are any property keys returned by the JSON representation of the entity. Examples are 'creatorId', 'name', etc. The following special key keywords are also valid: 'tags' performs a search on entity tags, 'tagpath' performs a hierarchical search on tags, with periods (.) as path level separators. 'freetext' performs a free text search across many fields of the entity"
  } ],
  "limit" : "The number of results to return. Default 100",
  "facetQuery" : "A string against which facet results are compared. If the facet result either CONTAINs, STARTSWITH, or is an EXACT match for this value, as specified by facetQueryMatchingMethod, then it is returned",
  "facetQueryMatchingMethod" : "The matching method used to filter when 'facetQuery' is used. Defaults to CONTAINS.",
  "facets" : [ "string" ]
}

$body#

Type: object

{
  "offset" : "The number of results to skip before returning values. Default: 0",
  "query" : [ {
    "negated" : "The flag to create a NOT operation. Default: false",
    "values" : [ "string" ],
    "matchingMethod" : "The method by which search matching is performed. Default: CONTAINS",
    "value" : "The entity facet value for which to search. Either value or values field is required. If both are set, values takes precedence.",
    "key" : "The entity facet (key) by which to search. Valid keys are any property keys returned by the JSON representation of the entity. Examples are 'creatorId', 'name', etc. The following special key keywords are also valid: 'tags' performs a search on entity tags, 'tagpath' performs a hierarchical search on tags, with periods (.) as path level separators. 'freetext' performs a free text search across many fields of the entity"
  } ],
  "limit" : "The number of results to return. Default: 100",
  "sort" : {
    "default" : "Whether this sort requests the default ranking order. Ascending/descending does not matter if this attribute is true.",
    "field" : "The facet by which to sort",
    "ascending" : "Whether to sort ascending. If undefined, sorting is not guaranteed"
  }
}

facet (required)#

Type: string

$body#

Type: object

{
  "offset" : "The number of results to skip before returning values. Default: 0",
  "query" : [ {
    "negated" : "The flag to create a NOT operation. Default: false",
    "values" : [ "string" ],
    "matchingMethod" : "The method by which search matching is performed. Default: CONTAINS",
    "value" : "The entity facet value for which to search. Either value or values field is required. If both are set, values takes precedence.",
    "key" : "The entity facet (key) by which to search. Valid keys are any property keys returned by the JSON representation of the entity. Examples are 'creatorId', 'name', etc. The following special key keywords are also valid: 'tags' performs a search on entity tags, 'tagpath' performs a hierarchical search on tags, with periods (.) as path level separators. 'freetext' performs a free text search across many fields of the entity"
  } ],
  "limit" : "The number of results to return. Default: 100",
  "facetQuery" : "A string against which facet results are compared. If the facet result CONTAINs, STARTSWITH, or is an EXACT match for this value, as specified by facetQueryMatchingMethod, then it is returned.",
  "facetQueryMatchingMethod" : "The matching method used to filter when 'facetQuery' is used. Defaults to CONTAINS."
}