Skip to main content
POST
/
business_metrics
Create business metric
curl --request POST \
  --url https://api.vantage.sh/v2/business_metrics \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "cost_report_tokens_with_metadata": [
    {
      "cost_report_token": "<string>",
      "unit_scale": "per_unit",
      "label_filter": [
        "<string>"
      ]
    }
  ],
  "values": [
    {
      "date": "2023-11-07T05:31:56Z",
      "amount": 123,
      "label": "<string>"
    }
  ],
  "forecasted_values": [
    {
      "date": "2023-11-07T05:31:56Z",
      "amount": 123,
      "label": "<string>"
    }
  ],
  "datadog_metric_fields": {
    "integration_token": "<string>",
    "query": "<string>"
  },
  "cloudwatch_fields": {
    "integration_token": "<string>",
    "stat": "<string>",
    "region": "<string>",
    "namespace": "<string>",
    "metric_name": "<string>",
    "label_dimension": "<string>",
    "dimensions": [
      {
        "name": "<string>",
        "value": "<string>"
      }
    ]
  }
}
'
{
  "token": "bsnss_mtrc_e8d0a6f35c9f4e8c",
  "title": "New Biz Metric",
  "created_by_token": "usr_464e70f8e230fa62",
  "cost_report_tokens_with_metadata": [
    {
      "cost_report_token": "rprt_67a1e1ac3bb7cefd",
      "unit_scale": "per_thousand",
      "label_filter": [
        "Dev",
        "Prod",
        "Staging",
        ""
      ]
    }
  ],
  "import_type": "csv",
  "integration_token": ""
}

Documentation Index

Fetch the complete documentation index at: https://docs.vantage.sh/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Create a new BusinessMetric.

title
string
required

The title of the BusinessMetrics.

cost_report_tokens_with_metadata
object[]

The tokens for any CostReports that use the BusinessMetric, the unit scale, and label filter.

values
object[]

The dates, amounts, and (optional) labels for the BusinessMetric.

forecasted_values
object[]

The dates, amounts, and (optional) labels for forecasted BusinessMetric values.

datadog_metric_fields
object

Datadog metric configuration fields

cloudwatch_fields
object

Cloudwatch configuration fields.

Response

BusinessMetric model

token
string
required

The token of the BusinessMetric.

Example:

"bsnss_mtrc_1234"

title
string
required

The title of the BusinessMetric.

Example:

"Total Revenue"

cost_report_tokens_with_metadata
object[]
required

The tokens for any CostReports that use the BusinessMetric, the unit scale, and label filter.

import_type
enum<string> | null
required

The type of import for the BusinessMetric.

Available options:
datadog_metrics,
cloudwatch,
snowflake_metrics,
csv
Example:

"datadog_metrics"

integration_token
string | null
required

The Integration token used to import the BusinessMetric.

created_by_token
string | null

The token of the Creator of the BusinessMetric.

Example:

"usr_1234"

cloudwatch_fields
object
datadog_metric_fields
object
snowflake_metric_fields
object