Vantage API Reference

{
  "resource_token": string // required // The token of the resource for which you are granting access,
  "team_token": string // required // The token of the Team you want to grant access to,
  "access": string // The access level you want to grant. Defaults to 'allowed'. Allowed values: `denied`, `allowed`
}

{
  "access": string // required // Allowed or denied access to resource. Allowed values: `denied`, `allowed`
}

{
  "status": string // required // The status of the Anomaly Alert,
  "feedback": string // Optional additional comments for why this alert is ignored
}

{
  "cost_report_token": string // required // The token of the Cost Report that has the notification,
  "threshold": integer // The threshold amount that must be met for the notification to fire,
  "user_tokens": [string] // The tokens of the Users that receive the notification,
  "recipient_channels": [string] // The Slack/MS Teams channels that receive the notification
}

{
  "threshold": integer // The threshold amount that must be met for the notification to fire,
  "user_tokens": [string] // The tokens of the users that receive the notification,
  "recipient_channels": [string] // The Slack/MS Teams channels that receive the notification
}

{
  "nickname": string // required // Display name for the billing profile,
  "billing_information_attributes": { // Billing address and contact information
    "token": string,
    "company_name": string // Company name for billing,
    "country_code": string // ISO country code,
    "address_line_1": string // First line of billing address,
    "address_line_2": string // Second line of billing address,
    "city": string // City for billing address,
    "state": string // State or province for billing address,
    "postal_code": string // Postal or ZIP code,
    "billing_email": [string] // Array of billing email addresses
  },
  "business_information_attributes": { // Business information and custom fields
    "token": string,
    "metadata": { // Business metadata including custom fields
      "custom_fields": [ // Array of custom field objects
        {
          "name": string // Custom field name,
          "value": string // Custom field value
        }
      ]
    }
  },
  "banking_information_attributes": { // Banking details (MSP accounts only)
    "token": string,
    "bank_name": string // Name of the bank,
    "beneficiary_name": string // Name of the account beneficiary,
    "tax_id": string // Tax identification number,
    "secure_data": { // Encrypted banking details
      "account_number": string // Bank account number (US),
      "routing_number": string // Bank routing number (US),
      "iban": string // International Bank Account Number (EU),
      "swift_bic": string // SWIFT/BIC code (EU)
    }
  },
  "invoice_adjustment_attributes": { // Invoice adjustments (taxes, fees, etc.)
    "token": string,
    "adjustment_items": [ // Array of adjustment items
      {
        "name": string // required // Name of the adjustment,
        "adjustment_type": string // Type of adjustment. Allowed values: `charge`, `credit`, `discount`,
        "calculation_type": string // required // How the adjustment is calculated. Allowed values: `fixed`, `percentage`,
        "amount": number // required // Amount or percentage value
      }
    ]
  }
}

{
  "nickname": string // Display name for the billing profile,
  "billing_information_attributes": { // Billing address and contact information
    "token": string,
    "company_name": string // Company name for billing,
    "country_code": string // ISO country code,
    "address_line_1": string // First line of billing address,
    "address_line_2": string // Second line of billing address,
    "city": string // City for billing address,
    "state": string // State or province for billing address,
    "postal_code": string // Postal or ZIP code,
    "billing_email": [string] // Array of billing email addresses
  },
  "business_information_attributes": { // Business information and custom fields
    "token": string,
    "metadata": { // Business metadata including custom fields
      "custom_fields": [ // Array of custom field objects
        {
          "name": string // Custom field name,
          "value": string // Custom field value
        }
      ]
    }
  },
  "banking_information_attributes": { // Banking details (MSP accounts only)
    "token": string,
    "bank_name": string // Name of the bank,
    "beneficiary_name": string // Name of the account beneficiary,
    "tax_id": string // Tax identification number,
    "secure_data": { // Encrypted banking details
      "account_number": string // Bank account number (US),
      "routing_number": string // Bank routing number (US),
      "iban": string // International Bank Account Number (EU),
      "swift_bic": string // SWIFT/BIC code (EU)
    }
  },
  "invoice_adjustment_attributes": { // Invoice adjustments (taxes, fees, etc.)
    "token": string,
    "adjustment_items": [ // Array of adjustment items
      {
        "name": string // required // Name of the adjustment,
        "adjustment_type": string // Type of adjustment. Allowed values: `charge`, `credit`, `discount`,
        "calculation_type": string // required // How the adjustment is calculated. Allowed values: `fixed`, `percentage`,
        "amount": number // required // Amount or percentage value
      }
    ]
  }
}

{
  "type": string // required // The type of the BillingRule. Note: the values are case insensitive. Allowed values: `exclusion`, `adjustment`, `credit`, `charge`, `custom`,
  "title": string // required // The title of the BillingRule,
  "start_period": string // The start period of the BillingRule. DEPRECATED: use start_date instead,
  "start_date": string // The start date of the BillingRule. ISO 8601 formatted,
  "end_date": string // The end date of the BillingRule. ISO 8601 formatted,
  "apply_to_all": boolean // Determines if the BillingRule applies to all current and future managed accounts,
  "charge_type": string // The charge type of the BillingRule. Required for Exclusion rules,
  "percentage": number // The percentage of the cost shown. Required for Adjustment rules. Example value: 75.0,
  "service": string // The service of the BillingRule. Required for Charge and Credit rules,
  "category": string // The category of the BillingRule. Required for Charge and Credit rules,
  "sub_category": string // The subcategory of the BillingRule. Required for Charge and Credit rules,
  "amount": number // The amount for the BillingRule. Required for Charge and Credit rules. Example value: 300,
  "sql_query": string // The SQL query for the BillingRule. Required for Custom rules. Example value: UPDATE costs SET costs.amount = costs.amount * 0.95
}

{
  "title": string // The title of the BillingRule,
  "charge_type": string // The charge type of the BillingRule,
  "percentage": number // The percentage of the cost shown. Example value: 75.0,
  "service": string // The service of the BillingRule,
  "category": string // The category of the BillingRule,
  "sub_category": string // The subcategory of the BillingRule,
  "start_period": string // The start period of the BillingRule,
  "amount": number // The credit amount for the BillingRule. Example value: 300,
  "start_date": string // The start date of the BillingRule. ISO 8601 formatted,
  "end_date": string // The end date of the BillingRule. ISO 8601 formatted,
  "apply_to_all": boolean // Determines if the BillingRule applies to all current and future managed accounts,
  "sql_query": string // The SQL query of the BillingRule
}

{
  "budget_tokens": [string] // required // The tokens of the Budget that has the alert,
  "threshold": integer // required // The threshold amount that must be met for the alert to fire,
  "user_tokens": [string] // The tokens of the users that receive the alert,
  "duration_in_days": string // required // The number of days from the start or end of the month to trigger the alert if the threshold is reached.  For the full month, pass an empty value,
  "period_to_track": string // The period tracked on the alert. Used with duration_in_days to determine the time window of the alert. Defaults to start_of_the_month if not passed. Possible values: start_of_the_month, end_of_the_month,
  "recipient_channels": [string] // The channels receiving the alerts. Requires an integration provider to be connected
}

{
  "budget_tokens": [string] // The tokens of the Budget that has the alert,
  "threshold": integer // The threshold amount that must be met for the alert to fire,
  "user_tokens": [string] // The tokens of the users that receive the alert,
  "duration_in_days": string // The number of days from the start or end of the month to trigger the alert if the threshold is reached. For the full month, pass an empty value,
  "period_to_track": string // The period tracked on the alert. Used with duration_in_days to determine the time window of the alert. Defaults to start_of_the_month if not passed. Possible values: start_of_the_month, end_of_the_month,
  "recipient_channels": [string] // The channels receiving the alerts. Requires an integration provider to be connected
}

{
  "name": string // required // The name of the Budget,
  "workspace_token": string // The token of the Workspace to add the Budget to,
  "cost_report_token": string // The CostReport token. Ignored for hierarchical Budgets,
  "child_budget_tokens": [string] // The tokens of any child Budgets when creating a hierarchical Budget,
  "periods": [ // The periods for the Budget. The start_at and end_at must be iso8601 formatted e.g. YYYY-MM-DD. Ignored for hierarchical Budgets
    {
      "start_at": string // required // The start date of the period,
      "end_at": string // The end date of the period,
      "amount": number // required // The amount of the period
    }
  ]
}

{
  "name": string // The name of the Budget,
  "cost_report_token": string // The CostReport token. Ignored for hierarchical Budgets,
  "child_budget_tokens": [string] // The tokens of any child Budgets when creating a hierarchical Budget,
  "periods": [ // The periods for the Budget. The start_at and end_at must be iso8601 formatted e.g. YYYY-MM-DD. Ignored for hierarchical Budgets
    {
      "start_at": string // required // The start date of the period,
      "end_at": string // The end date of the period,
      "amount": number // required // The amount of the period
    }
  ]
}

{
  "title": string // required // The title of the BusinessMetrics,
  "cost_report_tokens_with_metadata": [ // The tokens for any CostReports that use the BusinessMetric, the unit scale, and label filter
    {
      "cost_report_token": string // required // The token of the CostReport the BusinessMetric is attached to,
      "unit_scale": string // Determines the scale of the BusinessMetric's values within the CostReport. Allowed values: `per_unit`, `per_hundred`, `per_thousand`, `per_million`, `per_billion`,
      "calculation_type": string // The calculation type applied when this BusinessMetric is used in the CostReport. Allowed values: `unit_cost`, `gross_margin`, `usage_unit_cost`, `raw_business_metric`,
      "label": string // Optional custom display name for this BusinessMetric on the CostReport. When omitted, a default is derived from the calculation type,
      "label_filter": [string] // Include only values with these labels in the CostReport,
      "label_filters": object // Include only ClickHouse BusinessMetric values matching every label key and one of its values
    }
  ],
  "values": [ // The dates, amounts, and (optional) labels for the BusinessMetric
    {
      "date": string // required,
      "amount": number // required,
      "label": string
    }
  ],
  "forecasted_values": [ // The dates, amounts, and (optional) labels for forecasted BusinessMetric values
    {
      "date": string // required,
      "amount": number // required,
      "label": string
    }
  ],
  "datadog_metric_fields": { // Datadog metric configuration fields
    "integration_token": string // Integration token for the account from which you would like to fetch metrics,
    "query": string // Datadog metrics query string. e.g. sum:aws.applicationelb.request_count{region:us-east-1}.rollup(avg,daily)
  },
  "cloudwatch_fields": { // Cloudwatch configuration fields
    "integration_token": string // Integration token for the account from which you would like to fetch metrics,
    "stat": string,
    "region": string,
    "namespace": string,
    "metric_name": string,
    "label_dimension": string,
    "dimensions": [
      {
        "name": string,
        "value": string
      }
    ]
  },
  "snowflake_metric_fields": { // Snowflake metric configuration fields
    "integration_token": string // Integration token for the Snowflake integration from which you would like to fetch metrics,
    "sql_query": string // Snowflake SQL query returning date, value, and optional label columns
  }
}

{
  "title": string // The title of the BusinessMetric,
  "cost_report_tokens_with_metadata": [ // The tokens for any CostReports that use the BusinessMetric, and the unit scale
    {
      "cost_report_token": string // required // The token of the CostReport the BusinessMetric is attached to,
      "unit_scale": string // Determines the scale of the BusinessMetric's values within the CostReport. Allowed values: `per_unit`, `per_hundred`, `per_thousand`, `per_million`, `per_billion`,
      "calculation_type": string // The calculation type applied when this BusinessMetric is used in the CostReport. Allowed values: `unit_cost`, `gross_margin`, `usage_unit_cost`, `raw_business_metric`,
      "label": string // Optional custom display name for this BusinessMetric on the CostReport. When omitted, a default is derived from the calculation type,
      "label_filter": [string] // Include only values with these labels in the CostReport,
      "label_filters": object // Include only ClickHouse BusinessMetric values matching every label key and one of its values
    }
  ],
  "values": [ // The dates, amounts, and (optional) labels for the BusinessMetric
    {
      "date": string // required,
      "amount": number // required,
      "label": string
    }
  ],
  "forecasted_values": [ // The dates, amounts, and (optional) labels for forecasted BusinessMetric values
    {
      "date": string // required,
      "amount": number // required,
      "label": string
    }
  ],
  "datadog_metric_fields": { // Datadog metric configuration fields
    "integration_token": string // Integration token for the account from which you would like to fetch metrics,
    "query": string // Datadog metrics query string. e.g. sum:aws.applicationelb.request_count{region:us-east-1}.rollup(avg,daily)
  },
  "cloudwatch_fields": { // Cloudwatch configuration fields
    "integration_token": string // Integration token for the account from which you would like to fetch metrics,
    "stat": string,
    "region": string,
    "namespace": string,
    "metric_name": string,
    "label_dimension": string,
    "dimensions": [
      {
        "name": string,
        "value": string
      }
    ]
  },
  "snowflake_metric_fields": { // Snowflake metric configuration fields
    "integration_token": string // Integration token for the Snowflake integration from which you would like to fetch metrics,
    "sql_query": string // Snowflake SQL query returning date, value, and optional label columns
  }
}

{
  "title": string // required // The title of the Canvas,
  "prompt": string // required // The prompt used to generate the Canvas,
  "workspace_token": string // The token of the Workspace to add the Canvas to. Required if the API token is associated with multiple Workspaces
}

{
  "title": string // The title of the Canvas,
  "prompt": string // The prompt used to generate the Canvas
}

{
  "title": string // required // The title of the Cost Alert,
  "interval": string // required // The period of time used to compare costs. Options are 'day', 'week', 'month', 'quarter',
  "threshold": number // required // The threshold value for the Cost Alert,
  "unit_type": string // required // The unit type used to compare costs. Options are 'currency' or 'percentage',
  "workspace_token": string // required // The token of the Workspace to add the Cost Alert to,
  "report_tokens": [string] // required // The tokens of the reports to alert on,
  "email_recipients": [string] // The email recipients for the Cost Alert,
  "slack_channels": [string] // The Slack channels that will receive the alert,
  "teams_channels": [string] // The Microsoft Teams channels that will receive the alert,
  "minimum_threshold": number // The minimum monetary amount threshold for percentage-based alerts. Only applicable when unit_type is 'percentage'
}

{
  "title": string // The title of the Cost Alert,
  "email_recipients": [string] // The email recipients for the Cost Alert,
  "interval": string // The period of time used to compare costs. Options are 'day', 'week', 'month', 'quarter',
  "threshold": number // The threshold value for the Cost Alert,
  "slack_channels": [string] // The Slack channels that will receive the alert. Make sure your slack integration is connected at https://console.vantage.sh/settings/slack,
  "teams_channels": [string] // The Microsoft Teams channels that will receive the alert. Make sure your teams integration is connected at https://console.vantage.sh/settings/microsoft_teams,
  "unit_type": string // The unit type used to compare costs. Options are 'currency' or 'percentage',
  "report_tokens": [string] // The tokens of the reports to alert on,
  "minimum_threshold": number // The minimum monetary amount threshold for percentage-based alerts. Only applicable when unit_type is 'percentage'
}

{
  "title": string // required // The title of the CostReport,
  "workspace_token": string // The token of the Workspace to add the Cost Report to. Ignored if 'folder_token' is set. Required if the API token is associated with multiple Workspaces,
  "groupings": string // Grouping values for aggregating costs on the report. Valid groupings: account_id, billing_account_id, charge_type, cost_category, cost_subcategory, provider, region, resource_id, service, tagged, usage_unit, tag:tag_value. If providing multiple groupings, join as comma separated values: groupings=provider,service,region,
  "filter": string // The filter query language to apply to the CostReport. Additional documentation available at https://docs.vantage.sh/vql,
  "saved_filter_tokens": [string] // The tokens of the SavedFilters to apply to the CostReport,
  "business_metric_tokens_with_metadata": [ // The tokens for any BusinessMetrics to attach to the CostReport, and the unit scale
    {
      "business_metric_token": string // required // The token of the BusinessMetric to attach to the CostReport,
      "unit_scale": string // Determines the scale of the BusinessMetric's values within the CostReport. Allowed values: `per_unit`, `per_hundred`, `per_thousand`, `per_million`, `per_billion`,
      "calculation_type": string // The calculation type applied when this BusinessMetric is used in the CostReport. Allowed values: `unit_cost`, `gross_margin`, `usage_unit_cost`, `raw_business_metric`,
      "label": string // Optional custom display name for this BusinessMetric on the CostReport. When omitted, a default is derived from the calculation type,
      "label_filter": [string] // Include only values with these labels in the CostReport,
      "label_filters": object // Include only ClickHouse BusinessMetric values matching every label key and one of its values
    }
  ],
  "folder_token": string // The token of the Folder to add the CostReport to. Determines the Workspace the report is assigned to,
  "settings": { // Report settings
    "include_credits": boolean // Report will include credits,
    "include_refunds": boolean // Report will include refunds,
    "include_discounts": boolean // Report will include discounts,
    "include_tax": boolean // Report will include tax,
    "amortize": boolean // Report will amortize,
    "unallocated": boolean // Report will show unallocated costs,
    "aggregate_by": string // Report will aggregate by cost, usage, or count. Allowed values: `cost`, `usage`, `count`,
    "show_previous_period": boolean // Report will show previous period cost, usage, or count comparison,
    "complete_period": boolean // Report will restrict date ranges to completed periods only
  },
  "previous_period_start_date": string // The previous period start date of the CostReport. ISO 8601 Formatted,
  "previous_period_end_date": string // required // The previous period end date of the CostReport. ISO 8601 Formatted. Required when previous_period_start_date is provided,
  "start_date": string // The start date of the CostReport. ISO 8601 Formatted. Incompatible with 'date_interval' parameter,
  "end_date": string // required // The end date of the CostReport. ISO 8601 Formatted. Required when start_date is provided. Incompatible with 'date_interval' parameter,
  "date_interval": string // The date interval of the CostReport. Incompatible with 'start_date' and 'end_date' parameters. Defaults to 'this_month' if start_date and end_date are not provided. Allowed values: `this_month`, `last_7_days`, `last_30_days`, `last_month`, `last_3_months`, `last_6_months`, `custom`, `last_12_months`, `last_24_months`, `last_36_months`, `next_month`, `next_3_months`, `next_6_months`, `next_12_months`, `year_to_date`, `last_3_days`, `last_14_days`,
  "chart_type": string // The chart type of the CostReport. Allowed values: `area`, `line`, `pie`, `bar`, `multi_bar`,
  "date_bin": string // The date bin of the CostReport. Allowed values: `cumulative`, `day`, `week`, `month`, `quarter`, `hour`,
  "chart_settings": { // Report chart settings
    "x_axis_dimension": [string] // The dimension used to group or label data along the x-axis (e.g., by date, region, or service). NOTE: Only one value is allowed at this time. Defaults to ['date'],
    "y_axis_dimension": string // The metric or measure displayed on the chart’s y-axis. Possible values: 'cost', 'usage', 'count'. Defaults to 'cost'. Allowed values: `cost`, `usage`, `count`
  }
}

{
  "title": string // The title of the CostReport,
  "groupings": string // Grouping values for aggregating costs on the report. Valid groupings: account_id, billing_account_id, charge_type, cost_category, cost_subcategory, provider, region, resource_id, service, tagged, usage_unit, tag:tag_value. If providing multiple groupings, join as comma separated values: groupings=provider,service,region,
  "filter": string // The filter query language to apply to the CostReport. Additional documentation available at https://docs.vantage.sh/vql,
  "saved_filter_tokens": [string] // The tokens of the SavedFilters to apply to the CostReport,
  "business_metric_tokens_with_metadata": [ // The tokens for any BusinessMetrics to attach to the CostReport, and the unit scale
    {
      "business_metric_token": string // required // The token of the BusinessMetric to attach to the CostReport,
      "unit_scale": string // Determines the scale of the BusinessMetric's values within the CostReport. Allowed values: `per_unit`, `per_hundred`, `per_thousand`, `per_million`, `per_billion`,
      "calculation_type": string // The calculation type applied when this BusinessMetric is used in the CostReport. Allowed values: `unit_cost`, `gross_margin`, `usage_unit_cost`, `raw_business_metric`,
      "label": string // Optional custom display name for this BusinessMetric on the CostReport. When omitted, a default is derived from the calculation type,
      "label_filter": [string] // Include only values with these labels in the CostReport,
      "label_filters": object // Include only ClickHouse BusinessMetric values matching every label key and one of its values
    }
  ],
  "folder_token": string // The token of the Folder to add the CostReport to. Determines the Workspace the report is assigned to,
  "default_forecast": { // The default forecast selection for the CostReport
    "kind": string // required // The default forecast selection kind. Allowed values: `baseline`, `report_forecast`,
    "report_forecast_token": string // The token for the report forecast to set as default when kind is report_forecast
  },
  "settings": { // Report settings
    "include_credits": boolean // Report will include credits,
    "include_refunds": boolean // Report will include refunds,
    "include_discounts": boolean // Report will include discounts,
    "include_tax": boolean // Report will include tax,
    "amortize": boolean // Report will amortize,
    "unallocated": boolean // Report will show unallocated costs,
    "aggregate_by": string // Report will aggregate by cost, usage, or count. Allowed values: `cost`, `usage`, `count`,
    "show_previous_period": boolean // Report will show previous period cost, usage, or count comparison,
    "complete_period": boolean // Report will restrict date ranges to completed periods only
  },
  "chart_settings": { // Report chart settings
    "x_axis_dimension": [string] // The dimension used to group or label data along the x-axis (e.g., by date, region, or service). NOTE: Only one value is allowed at this time. Defaults to ['date'],
    "y_axis_dimension": string // The metric or measure displayed on the chart’s y-axis. Possible values: 'cost', 'usage', 'count'. Defaults to 'cost'. Allowed values: `cost`, `usage`, `count`
  },
  "previous_period_start_date": string // The previous period start date of the CostReport. ISO 8601 Formatted,
  "previous_period_end_date": string // The previous period end date of the CostReport. ISO 8601 Formatted. Required when previous_period_start_date is provided,
  "start_date": string // The start date of the CostReport. ISO 8601 Formatted. Incompatible with 'date_interval' parameter,
  "end_date": string // The end date of the CostReport. ISO 8601 Formatted. Required when start_date is provided. Incompatible with 'date_interval' parameter,
  "date_interval": string // The date interval of the CostReport. Incompatible with 'start_date' and 'end_date' parameters. Defaults to 'this_month' if start_date and end_date are not provided. Allowed values: `this_month`, `last_7_days`, `last_30_days`, `last_month`, `last_3_months`, `last_6_months`, `custom`, `last_12_months`, `last_24_months`, `last_36_months`, `next_month`, `next_3_months`, `next_6_months`, `next_12_months`, `year_to_date`, `last_3_days`, `last_14_days`,
  "chart_type": string // The chart type of the CostReport. Allowed values: `area`, `line`, `pie`, `bar`, `multi_bar`,
  "date_bin": string // The date bin of the CostReport. Allowed values: `cumulative`, `day`, `week`, `month`, `quarter`, `hour`
}

{
  "cost_report_token": string // The CostReport token,
  "filter": string // The VQL filter to apply to the costs. If this is supplied you do not need cost_report_token,
  "workspace_token": string // The token of the Workspace to query costs from. Ignored if 'cost_report_token' is set. Required if the API token is associated with multiple Workspaces,
  "start_date": string // First date you would like to filter costs from. ISO 8601 formatted,
  "end_date": string // Last date you would like to filter costs to. ISO 8601 formatted,
  "groupings": [string] // Group the results by specific field(s). Defaults to provider, service, account_id. Valid groupings: account_id, billing_account_id, charge_type, cost_category, cost_subcategory, provider, region, resource_id, service, tagged, usage_unit, tag:tag_value. If providing multiple groupings, join as comma separated values: groupings=provider,service,region,
  "date_bin": string // The date bin of the costs. Defaults to the report's default or day. Allowed values: `day`, `week`, `month`, `quarter`, `hour`,
  "schema": string // The schema of the data export. Allowed values: `vntg`, `focus`, `comparison`,
  "settings": { // Cost-related settings
    "include_credits": boolean // Results will include credits,
    "include_refunds": boolean // Results will include refunds,
    "include_discounts": boolean // Results will include discounts,
    "include_tax": boolean // Results will include tax,
    "amortize": boolean // Results will amortize,
    "unallocated": boolean // Results will show unallocated costs,
    "aggregate_by": string // Results will aggregate by cost, usage, or count. Allowed values: `cost`, `usage`, `count`,
    "show_previous_period": boolean // Results will show previous period cost, usage, or count comparison
  }
}

{
  "title": string // required // The title of the Dashboard,
  "widgets": [ // The widgets to add to the Dashboard. Currently supports CostReport, ResourceReport, KubernetesEfficiencyReport, FinancialCommitmentReport, and RecommendationView
    {
      "widgetable_token": string // required // The token of the represented Resource,
      "title": string // The title of the Widget (defaults to the title of the Resource),
      "settings": { // The settings for the DashboardWidget
        "display_type": string // required // Allowed values: `table`, `chart`
      }
    }
  ],
  "saved_filter_tokens": [string] // The tokens of the Saved Filters used in the Dashboard,
  "date_bin": string // Determines how to group costs in the Dashboard. Allowed values: `cumulative`, `day`, `week`, `month`,
  "date_interval": string // Determines the date range in the Dashboard. Incompatible with 'start_date' and 'end_date' parameters. Allowed values: `this_month`, `last_7_days`, `last_30_days`, `last_month`, `last_3_months`, `last_6_months`, `custom`, `last_12_months`, `last_24_months`, `last_36_months`, `next_month`, `next_3_months`, `next_6_months`, `next_12_months`, `year_to_date`, `last_3_days`, `last_14_days`,
  "start_date": string // The start date for the date range for costs in the Dashboard. ISO 8601 Formatted. Incompatible with 'date_interval' parameter,
  "end_date": string // The end date for the date range for costs in the Dashboard. ISO 8601 Formatted. Incompatible with 'date_interval' parameter,
  "workspace_token": string // The token of the Workspace to add the Dashboard to. Required if the API token is associated with multiple Workspaces
}

{
  "title": string // The title of the Dashboard,
  "widgets": [ // The widgets to add to the Dashboard. Currently supports CostReport, ResourceReport, KubernetesEfficiencyReport, FinancialCommitmentReport, and RecommendationView
    {
      "widgetable_token": string // required // The token of the represented Resource,
      "title": string // The title of the Widget (defaults to the title of the Resource),
      "settings": { // The settings for the DashboardWidget
        "display_type": string // required // Allowed values: `table`, `chart`
      }
    }
  ],
  "saved_filter_tokens": [string] // The tokens of the Saved Filters used in the Dashboard,
  "date_bin": string // Determines how to group costs in the Dashboard. Allowed values: `cumulative`, `day`, `week`, `month`,
  "date_interval": string // Determines the date range in the Dashboard. Incompatible with 'start_date' and 'end_date' parameters. Allowed values: `this_month`, `last_7_days`, `last_30_days`, `last_month`, `last_3_months`, `last_6_months`, `custom`, `last_12_months`, `last_24_months`, `last_36_months`, `next_month`, `next_3_months`, `next_6_months`, `next_12_months`, `year_to_date`, `last_3_days`, `last_14_days`, ``,
  "start_date": string // The start date for the date range for costs in the Dashboard. ISO 8601 Formatted. Incompatible with 'date_interval' parameter,
  "end_date": string // The end date for the date range for costs in the Dashboard. ISO 8601 Formatted. Incompatible with 'date_interval' parameter,
  "workspace_token": string // The token of the Workspace the Dashboard belongs to. Required if the API token is associated with multiple Workspaces
}

{
  "workspace_token": string // required // The Workspace in which the FinancialCommitmentReport will be created,
  "title": string // required // The title of the FinancialCommitmentReport,
  "filter": string // The filter query language to apply to the FinancialCommitmentReport. Additional documentation available at https://docs.vantage.sh/vql,
  "start_date": string // The start date of the FinancialCommitmentReport. YYYY-MM-DD formatted. Incompatible with 'date_interval' parameter,
  "end_date": string // The end date of the FinancialCommitmentReport. YYYY-MM-DD formatted. Incompatible with 'date_interval' parameter,
  "date_interval": string // The date interval of the FinancialCommitmentReport. Unless 'custom' is used, this is incompatible with 'start_date' and 'end_date' parameters. Defaults to 'last_3_months'. Allowed values: `this_month`, `last_7_days`, `last_30_days`, `last_month`, `last_3_months`, `last_6_months`, `custom`, `last_12_months`, `last_24_months`, `last_36_months`, `year_to_date`, `last_3_days`, `last_14_days`,
  "date_bucket": string // The date bucket of the FinancialCommitmentReport. Allowed values: `hour`, `day`, `week`, `month`, `quarter`,
  "on_demand_costs_scope": string // The scope for the costs. Possible values: discountable, all. Allowed values: `discountable`, `all`,
  "groupings": [string] // Grouping values for aggregating costs on the FinancialCommitmentReport. Valid groupings: cost_type, commitment_type, commitment_id, service, resource_account_id, provider_account_id, region, cost_category, cost_sub_category, instance_type, tag, tag:label_name
}

{
  "title": string // The title of the FinancialCommitmentReport,
  "filter": string // The filter query language to apply to the FinancialCommitmentReport. Additional documentation available at https://docs.vantage.sh/vql,
  "start_date": string // The start date of the FinancialCommitmentReport. YYYY-MM-DD formatted. Incompatible with 'date_interval' parameter,
  "end_date": string // The end date of the FinancialCommitmentReport. YYYY-MM-DD formatted. Incompatible with 'date_interval' parameter,
  "date_interval": string // The date interval of the FinancialCommitmentReport. Unless 'custom' is used, this is incompatible with 'start_date' and 'end_date' parameters. Defaults to 'last_3_months'. Allowed values: `this_month`, `last_7_days`, `last_30_days`, `last_month`, `last_3_months`, `last_6_months`, `custom`, `last_12_months`, `last_24_months`, `last_36_months`, `year_to_date`, `last_3_days`, `last_14_days`,
  "date_bucket": string // The date bucket of the FinancialCommitmentReport. Allowed values: `hour`, `day`, `week`, `month`, `quarter`,
  "on_demand_costs_scope": string // The scope for the costs. Possible values: discountable, all. Allowed values: `discountable`, `all`,
  "groupings": [string] // Grouping values for aggregating costs on the FinancialCommitmentReport. Valid groupings: cost_type, commitment_type, commitment_id, service, resource_account_id, provider_account_id, region, cost_category, cost_sub_category, instance_type, tag, tag:label_name
}

{
  "title": string // required // The title of the Folder,
  "parent_folder_token": string // The token of the parent Folder,
  "saved_filter_tokens": [string] // The tokens of the SavedFilters to apply to any Cost Report contained within the Folder,
  "workspace_token": string // The token of the Workspace to add the Folder to. Ignored if 'parent_folder_token' is set. Required if the API token is associated with multiple Workspaces,
  "type": string // The type of the Folder. Allowed values: `CostFolder`, `ProviderResourceFolder`
}

{
  "title": string // The title of the Folder,
  "parent_folder_token": string // The token of the parent Folder,
  "saved_filter_tokens": [string] // The tokens of the SavedFilters to apply to any Cost Report contained within the Folder
}

{
  "tenant": string // required // Azure AD Tenant ID,
  "app_id": string // required // Service Principal Application ID,
  "password": string // required // Service Principal Password
}

{
  "name": string // required // Name of the Custom Provider Integration,
  "description": string // Description of the Custom Provider Integration
}

{
  "billing_account_id": string // required // GCP billing account ID,
  "project_id": string // required // GCP project ID,
  "dataset_name": string // required // BigQuery dataset name
}

{
  "workspace_tokens": [string] // The Workspace tokens to associate to the Integration
}