---
title: Vantage API Integration on Truto
slug: vantage
category: Observability
canonical: "https://truto.one/integrations/detail/vantage/"
---

# Vantage API Integration on Truto



**Category:** Observability  
**Status:** Beta

## MCP-ready AI tools

Truto exposes 226 tools for Vantage that AI agents can call directly.

- **list_all_vantage_access_grants** — List all Access Grants in Vantage that the current API token can access. Returns records with token, resource_token, access, team_token, created_at, and created_by. Optional page and limit (max 1000).
- **create_a_vantage_access_grant** — Create an Access Grant in Vantage that grants or denies a team's access to a resource. Returns: token, resource_token, access, team_token, created_at, created_by. Optional body fields: resource_token, access, team_token. Required: resource_token, team_token.
- **get_single_vantage_access_grant_by_id** — Get a specific Access Grant in Vantage by its token. Returns: token, resource_token, access, team_token, created_at, created_by. Required: id.
- **update_a_vantage_access_grant_by_id** — Update an Access Grant in Vantage, for example to change the access level a team has on a resource. Returns: token, resource_token, access, team_token, created_at, created_by. Required: id, access.
- **delete_a_vantage_access_grant_by_id** — Delete an Access Grant in Vantage by its token. Returns an empty 204 response on success. Required: id.
- **list_all_vantage_access_policies** — List all Access Policies for the current account in vantage. Returns each policy's token, title, description, policy (with VQL filter), team_tokens, created_by, and created_at. Max 1000 per page.
- **create_a_vantage_access_policy** — Create an Access Policy in vantage that limits cost visibility for selected teams via a VQL filter. Returns the created policy object including token, title, description, policy, team_tokens, and created_at. Requires a JSON body with the policy definition. Required: title, policy.
- **update_a_vantage_access_policy_by_id** — Update an Access Policy by id in vantage, for example to change its title, description, VQL filter, or team assignments. Returns the updated policy object including token, title, description, policy, team_tokens, created_by, and created_at. Required: id.
- **delete_a_vantage_access_policy_by_id** — Delete an Access Policy by id in vantage. Returns an empty 204 response on success. Required: id.
- **list_all_vantage_anomaly_alerts** — List all anomaly alerts in Vantage that the API token can access, filterable by date range, provider, service, cost category, or cost report token. Returns: token, created_at, alerted_at, category, service, provider, amount, previous_amount, seven_day_average, status, feedback, resources, resource_tokens, cost_report_token. Max 1000 per page.
- **get_single_vantage_anomaly_alert_by_id** — Get a single anomaly alert in Vantage by its id. Returns: token, created_at, alerted_at, category, service, provider, amount, previous_amount, seven_day_average, status, feedback, resources, resource_tokens, cost_report_token. Required: id.
- **update_a_vantage_anomaly_alert_by_id** — Update an anomaly alert in Vantage by its id — set its status (e.g. active or archived) and attach feedback. Returns the updated alert including token, status, feedback, amount, and service. Required: id, status.
- **list_all_vantage_anomaly_notifications** — List all Anomaly Notifications in Vantage. Returns: token, cost_report_token, created_at, updated_at, threshold, user_tokens, recipient_emails, recipient_channels. Max 1000 results per page.
- **create_a_vantage_anomaly_notification** — Create an Anomaly Notification for a Cost Report in Vantage. Returns the created notification with token, cost_report_token, threshold, user_tokens, recipient_channels, created_at, and updated_at. Required: cost_report_token.
- **get_single_vantage_anomaly_notification_by_id** — Get a single Anomaly Notification by id in Vantage. Returns: token, cost_report_token, created_at, updated_at, threshold, user_tokens, recipient_emails, recipient_channels. Required: id.
- **update_a_vantage_anomaly_notification_by_id** — Update an Anomaly Notification by id in Vantage. Returns the updated notification with token, cost_report_token, threshold, user_tokens, recipient_channels, created_at, and updated_at. Requires a JSON body. Required: id.
- **delete_a_vantage_anomaly_notification_by_id** — Delete an Anomaly Notification by id in Vantage. Returns an empty 204 response on success. Required: id.
- **list_all_vantage_annotations** — List all annotations in Vantage. Returns each annotation with token, title, report_tokens, date, and message. Filter by report_token. Max 5000 per page.
- **create_a_vantage_annotation** — Create an annotation in Vantage attached to one or more Cost Reports. Returns the created annotation with token, title, report_tokens, date, and message. Requires a JSON body (title, report_tokens, date, message). Required: report_tokens, date, message.
- **update_a_vantage_annotation_by_id** — Update an annotation in Vantage by id (the Annotation's token, e.g. issue_946526bd88c296c6). Returns the updated annotation with token, title, report_tokens, date, and message. Requires a JSON body (title, report_tokens, date, message). Required: id.
- **delete_a_vantage_annotation_by_id** — Delete an annotation in Vantage by id (the Annotation's token, e.g. issue_946526bd88c296c6). Returns an empty 204 response on success. Required: id.
- **list_all_vantage_audit_logs** — List vantage audit logs. Returns: token, object_token, object_type, object_title, event, source, user, workspace_title, workspace_token, created_at, changed_values, unchanged_values, object_changes. new values). Filter by user, workspace_token, action, source, object_type, object_token, or date range. Max 5000 per page.
- **get_single_vantage_audit_log_by_id** — Get a vantage audit log by id (the audit log token, e.g. adt_lg_...). Returns: token, object_token, object_type, object_title, event, source, user, workspace_title, workspace_token, created_at, changed_values, unchanged_values, object_changes. Required: id.
- **list_all_vantage_billing_profiles** — List all Vantage billing profiles (requires MSP invoicing on the account). Returns each profile's token, created_at, and updated_at. Max 1000 per page.
- **create_a_vantage_billing_profile** — Create a Vantage billing profile (requires MSP invoicing on the account). Returns the created profile with its token, created_at, and updated_at. Requires a JSON request body (upstream createBillingProfile schema). Required: nickname.
- **get_single_vantage_billing_profile_by_id** — Get a single Vantage billing profile by id (its billing profile token). Returns: token, nickname, created_at, updated_at, billing_information_attributes, business_information_attributes, banking_information_attributes, invoice_adjustment_attributes, managed_accounts_count. Requires MSP invoicing to be enabled on the account. Required: id.
- **update_a_vantage_billing_profile_by_id** — Update a Vantage billing profile by id (its billing profile token). Returns: token, nickname, created_at, updated_at, billing_information_attributes, business_information_attributes, banking_information_attributes, invoice_adjustment_attributes, managed_accounts_count. Requires MSP invoicing to be enabled on the account. Required: id.
- **delete_a_vantage_billing_profile_by_id** — Delete a Vantage billing profile by id (its billing profile token). Returns an empty 204 response on success. Required: id.
- **list_all_vantage_billing_rules** — List all vantage billing rules. Returns each rule's token, title, type, created_at, and type-specific fields like charge_type. Max 1000 per page.
- **create_a_vantage_billing_rule** — Create a billing rule in vantage (a Credit, Exclusion, or Adjustment rule). Returns the created rule's token, title, type, service, amount, and created_at. Required: type, title.
- **get_single_vantage_billing_rule_by_id** — Get a single vantage billing rule by id (the billing rule token). Returns: token, title, type, start_date, end_date, apply_to_all, created_by_token, created_at, service, category, percentage, charge_type, sub_category, start_period, amount, sql_query, adjusted_rate. Required: id.
- **update_a_vantage_billing_rule_by_id** — Update a vantage billing rule by id (the billing rule token). Returns the updated rule's token, title, type, created_at, and type-specific fields like service and adjusted_rate. Required: id.
- **delete_a_vantage_billing_rule_by_id** — Delete a vantage billing rule by id. Returns an empty 204 response on success. Required: id.
- **list_all_vantage_budget_alerts** — List all budget alerts in Vantage. Returns each alert's token, title, periodic_threshold, budget_token, and created_at. Optional filters: workspace_token and budget_token.
- **create_a_vantage_budget_alert** — Create a budget alert in Vantage. Returns the created BudgetAlert record (id plus its schema-specific attributes). Requires a JSON request body; field-level details are not enumerated in the available source, so consult https://docs.vantage.sh/api for the full payload shape. Required: budget_tokens, threshold, duration_in_days.
- **get_single_vantage_budget_alert_by_id** — Get a single budget alert in Vantage by its id (budget alert token). Returns the BudgetAlert record (id plus its schema-specific attributes). Required: id.
- **update_a_vantage_budget_alert_by_id** — Update an existing budget alert in Vantage by its id (budget alert token). Returns the updated BudgetAlert record (id plus its schema-specific attributes). Required: id.
- **delete_a_vantage_budget_alert_by_id** — Delete a budget alert in Vantage by its id (budget alert token). Returns an empty 204 response on success. Required: id.
- **list_all_vantage_budgets** — List all budgets in Vantage. Returns each budget's token, name, workspace_token, created_at, period_cadence, periods, and performance.
- **create_a_vantage_budget** — Create a budget in Vantage. Returns the created budget with token, name, workspace_token, created_at, period_cadence, and periods. Required: name.
- **get_single_vantage_budget_by_id** — Get a single Vantage budget by id. Returns: token, name, type, unit, workspace_token, user_token, created_by_token, cost_report_token, created_at, budget_alert_tokens, child_budget_tokens, period_cadence, periods, performance.g. bdgt_24068dbacaaad7fb). Required: id.
- **update_a_vantage_budget_by_id** — Update a Vantage budget by id. Returns the updated budget with token, name, workspace_token, period_cadence, periods, and performance.g. bdgt_39ce7f848dff6d54). Required: id.
- **delete_a_vantage_budget_by_id** — Delete a Vantage budget by id. Returns an empty 204 response on success. Required: id.
- **list_all_vantage_business_metrics** — List all Vantage business metrics accessible to the current API token. Returns records with token, title, created_by_token, import_type, cost_report_tokens_with_metadata, and integration_token (plus cloudwatch_fields or datadog_metric_fields where applicable). Optional: q to search by title; max 5000 results per page.
- **create_a_vantage_business_metric** — Create a new Vantage business metric. Returns the created metric with token, title, created_by_token, cost_report_tokens_with_metadata, and import_type. Requires title. Required: title.
- **get_single_vantage_business_metric_by_id** — Get a Vantage business metric by id (the business metric token, e.g. bsnss_mtrc_...). Returns: token, title, created_by_token, cost_report_tokens_with_metadata, import_type, integration_token, cloudwatch_fields, datadog_metric_fields, gcp_bigquery_metric_fields, snowflake_metric_fields, clickhouse_metric_fields. Required: id.
- **update_a_vantage_business_metric_by_id** — Update an existing Vantage business metric by id, e.g. to rename its title. Returns the updated metric with token, title, cost_report_tokens_with_metadata, and import_type. Required: id.
- **delete_a_vantage_business_metric_by_id** — Delete a Vantage business metric by id. Returns an empty 204 response on success. Required: id.
- **list_all_vantage_business_metric_labels** — List the labels of a Vantage business metric (e.g. alpha, beta, Enterprise). Returns: value. Max 5000 per page. Required: business_metric_token.
- **list_all_vantage_business_metric_values** — List values of a Vantage business metric by token. Returns value records with date and amount. Required: business_metric_token.
- **vantage_business_metric_values_bulk_delete** — Delete historical or forecasted values of a Vantage business metric by token. Returns: deleted_count. Metrics stored in ClickHouse only support deleting every historical or every forecasted value; supplying start_date, end_date, or label then returns 422. Required: business_metric_token.
- **vantage_business_metric_values_bulk_update** — Update the values of a Vantage business metric by uploading a CSV file. Returns the updated metric with token, title, created_by_token, import_type, and cost_report_tokens_with_metadata. Required: business_metric_token.
- **list_all_vantage_business_metric_forecasted_values** — List forecasted values for a business metric in Vantage. Returns value records with date and amount. Required: business_metric_token.
- **list_all_vantage_canvases** — List all Vantage canvases. Returns canvas objects, one per item in the collection. Max 1000 results per page.
- **create_a_vantage_canvase** — Create a Vantage canvas. Returns the created canvas object. Requires a JSON request body matching Vantage's createCanvas schema. Required: title, prompt.
- **get_single_vantage_canvase_by_id** — Get a single Vantage canvas by id (the canvas token). Returns the canvas object. Required: id.
- **update_a_vantage_canvase_by_id** — Update a Vantage canvas by id (the canvas token). Returns the updated canvas object. Requires a JSON request body matching Vantage's updateCanvas schema. Required: id.
- **delete_a_vantage_canvase_by_id** — Delete a Vantage canvas by id (the canvas token). Returns an empty 204 response on success. Required: id.
- **list_all_vantage_cost_alert_events** — List all cost alert events for a Vantage cost alert. Returns each event with its token, created_at, triggered_at, description, alert_type, metadata, report_token, and alert_token. Max 1000 results per page. Required: cost_alert_token.
- **get_single_vantage_cost_alert_event_by_id** — Get a single Vantage cost alert event by id. Returns: token, created_at, triggered_at, description, alert_type, metadata, report_token, alert_token. Required: id, cost_alert_token.
- **list_all_vantage_cost_alerts** — List all Vantage cost alerts. Returns each alert's token, title, interval, threshold, unit_type, and report_tokens. Max 5000 per page.
- **create_a_vantage_cost_alert** — Create a Vantage cost alert. Returns the created alert including token, title, interval, threshold, unit_type, and report_tokens. Requires title and workspace_token. Required: title, interval, threshold, unit_type, workspace_token, report_tokens.
- **get_single_vantage_cost_alert_by_id** — Get a single Vantage cost alert by id (the cost alert token). Returns: token, title, email_recipients, slack_channels, teams_channels, created_at, updated_at, workspace_token, interval, threshold, unit_type, minimum_threshold, report_tokens. Required: id.
- **update_a_vantage_cost_alert_by_id** — Update a Vantage cost alert by id (the cost alert token). Returns the updated alert including token, title, interval, threshold, unit_type, and report_tokens. Required: id.
- **delete_a_vantage_cost_alert_by_id** — Delete a Vantage cost alert by id (the cost alert token). Returns an empty 204 response on success. Required: id.
- **list_all_vantage_cost_provider_accounts** — List cost provider accounts available in a vantage Workspace. Returns the title, account_id, provider_uuid, and provider of each account. Supply workspace_token when the API token is associated with multiple Workspaces.
- **list_all_vantage_cost_reports** — List Vantage cost reports, optionally filtered by folder, workspace, or a title search. Returns each report's token, title, folder_token, filter, groupings, settings, date_interval, chart_type, and date_bin. Max 1000 results per page.
- **create_a_vantage_cost_report** — Create a Vantage cost report with a title, folder, VQL filter, groupings, and chart configuration. Returns the created report's token, title, folder_token, filter, groupings, settings, date_interval, chart_type, and date_bin. Required: title, previous_period_end_date, end_date.
- **get_single_vantage_cost_report_by_id** — Get a single Vantage cost report by id. Returns the report's token, title, folder_token, filter, groupings, settings, date_interval, chart_type, and date_bin. Required: id.
- **update_a_vantage_cost_report_by_id** — Update a Vantage cost report by id, changing its title, folder, VQL filter, groupings, settings, or chart configuration. Returns the updated report's token, title, folder_token, filter, groupings, settings, date_interval, chart_type, and date_bin. Required: id.
- **delete_a_vantage_cost_report_by_id** — Delete a Vantage cost report by id. Returns an empty 204 response on success. Required: id.
- **list_all_vantage_cost_report_forecasted_costs** — List forecasted costs for a vantage cost report. Returns each forecasted cost with its date, amount, provider, and service. Max 1000 results per page. Required: cost_report_token.
- **create_a_vantage_costs_data_export** — Generate a cost data export in vantage. The export is queued and processed asynchronously — poll its status afterwards to retrieve the results. Returns the DataExport record including token, status, created_at, export_type, and a manifest with the generated CSV file URLs once complete. Requires a JSON request body.
- **list_all_vantage_costs** — List vantage costs for a cost report or a VQL filter, with configurable date range, groupings, date bin, and aggregation settings. Returns per-cost records including accrued_at, amount, currency, provider, account_id, service, and usage. Supply either cost_report_token or a VQL filter to scope the query. Max 5000 results per page.
- **list_all_vantage_dashboards** — List all Vantage dashboards, optionally filtered by title search or workspace. Returns: token, title, widgets, saved_filter_tokens, date_bin, date_interval, start_date, end_date, created_at, updated_at, workspace_token, widget_tokens. Max 1000 per page.
- **create_a_vantage_dashboard** — Create a Vantage dashboard with a title, widgets, and date settings. Returns the created dashboard including token, title, widget_tokens, widgets, date_interval, and workspace_token. Required: title.
- **get_single_vantage_dashboard_by_id** — Get a specific Vantage dashboard by id (its dashboard token). Returns: token, title, widgets, saved_filter_tokens, date_bin, date_interval, start_date, end_date, created_at, updated_at, workspace_token, widget_tokens. Required: id.
- **update_a_vantage_dashboard_by_id** — Update a Vantage dashboard identified by id (its dashboard token). Returns the updated dashboard including token, title, widgets, date_interval, and created_at. Required: id.
- **delete_a_vantage_dashboard_by_id** — Delete a Vantage dashboard by id (its dashboard token). Returns an empty 204 response on success. Required: id.
- **get_single_vantage_data_export_by_id** — Get a Vantage data export by id (its data export token). Returns: token, status, created_at, export_type, manifest, attributes. Exports are generated asynchronously — while still pending, keep polling until the manifest is populated. Required: id.
- **list_all_vantage_enrichment_sources** — List all enrichment sources in vantage. Returns each source with token, type, title, integration_token, active, and created_at. Max 1000 per page.
- **get_single_vantage_enrichment_source_by_id** — Get a single enrichment source in vantage by its id (the enrichment source token). Returns: token, type, title, integration_token, active, created_at. Required: id.
- **list_all_vantage_enrichment_source_statistics** — List enrichment statistics for a Vantage enrichment source, one record per ingested cost period. Returns: token, provider, account_identifier, status, status_detail, status_message, start_date, end_date, ingested_at, log_scan_acceptance_rate, log_record_match_rate, bill_match_rate, ambiguous_sibling_rows, tokens_kept_rate. Required: enrichment_source_token.
- **list_all_vantage_exchange_rates** — List all exchange rates configured in Vantage. Returns each rate with its base_currency_code, currency_code, rate, effective_date, and updated_at. Maximum 1000 results per page.
- **create_a_vantage_exchange_rates_csv** — Upload exchange rates to Vantage via a CSV file. Returns an empty 201 response on success.
- **list_all_vantage_financial_commitment_reports** — List all financial commitment reports in Vantage. Returns reports including token, title, created_at, workspace_token, start_date, end_date, date_interval, date_bucket, groupings, on_demand_costs_scope, filter, default, and user_token. Filter by title with q or by workspace with workspace_token.
- **create_a_vantage_financial_commitment_report** — Create a financial commitment report in Vantage. Returns the created report including token, title, created_at, workspace_token, start_date, end_date, date_interval, date_bucket, groupings, on_demand_costs_scope, and filter. Required: workspace_token, title.
- **get_single_vantage_financial_commitment_report_by_id** — Get a single financial commitment report in Vantage by id. Returns the report including token, title, created_at, workspace_token, start_date, end_date, date_interval, date_bucket, groupings, on_demand_costs_scope, and filter. Required: id.
- **update_a_vantage_financial_commitment_report_by_id** — Update a financial commitment report in Vantage by id, e.g. change its title, date range, date bucket, groupings, or filter. Returns the updated report including token, title, created_at, workspace_token, start_date, end_date, date_interval, date_bucket, groupings, on_demand_costs_scope, and filter. Required: id.
- **delete_a_vantage_financial_commitment_report_by_id** — Delete a financial commitment report in Vantage by id. Returns an empty 204 response on success. Required: id.
- **list_all_vantage_financial_commitment_report_costs** — List costs for a Vantage financial commitment report, filterable by date range, date bin, groupings, and VQL filter. Returns: accrued_at, amount, gross_amount, on_demand_amount, covered_gross_amount, currency, cost_type, commitment_type, commitment_id, service, resource_account_id, provider_account_id, region, cost_category, cost_sub_category, instance_type, tags, provider, account_id. Required: financial_commitment_report_token.
- **list_all_vantage_financial_commitments** — List all financial commitments in Vantage across your workspaces, such as AWS Savings Plans. Returns each commitment's commitment_type, service, account, type, term, payment_type, region, purchase_date, expiration_date, commitment amount, status, created_at, and workspace_token. Max 1000 records per page.
- **list_all_vantage_folders** — List all Vantage folders for Cost Reports. Returns: token, title, type, parent_folder_token, saved_filter_tokens, created_at, updated_at, workspace_token. Filter by type, q (title search), or workspace_token; max 1000 per page.
- **create_a_vantage_folder** — Create a Vantage folder for organizing Cost Reports. Returns: token, title, type, parent_folder_token, saved_filter_tokens, created_at, updated_at, workspace_token. Requires title and workspace_token; optionally set parent_folder_token to nest the folder. Required: title.
- **get_single_vantage_folder_by_id** — Get a single Vantage folder by id (the folder token, e.g. fldr_3653e0f460786b1e). Returns: token, title, type, parent_folder_token, saved_filter_tokens, created_at, updated_at, workspace_token. Required: id.
- **update_a_vantage_folder_by_id** — Update a Vantage folder by id (the folder token), e.g. to rename it or move it under a parent folder. Returns: token, title, type, parent_folder_token, saved_filter_tokens, created_at, updated_at, workspace_token. Required: id.
- **delete_a_vantage_folder_by_id** — Delete a Vantage folder by id (the folder token). Returns an empty 204 response on success. Required: id.
- **list_all_vantage_integrations** — List all provider integrations in Vantage. Returns: token, provider, account_identifier, status, last_updated, workspace_tokens, created_at, managed_account_tokens, enriched_by. Supports provider and account_identifier filters; maximum 1000 results per page.
- **get_single_vantage_integration_by_id** — Get a single Vantage integration by its token. Returns: token, provider, account_identifier, status, last_updated, workspace_tokens, created_at, managed_account_tokens, enriched_by. Required: id.
- **update_a_vantage_integration_by_id** — Update a Vantage integration by its token. Returns the updated Integration object with token, provider, account_identifier, status, last_updated, and workspace_tokens. Required: id.
- **delete_a_vantage_integration_by_id** — Delete a Vantage integration by its token. Returns an empty 204 response on success. Required: id.
- **create_a_vantage_integrations_custom_provider** — Create a Custom Provider Integration in Vantage for ingesting custom cost data. Returns the created integration object including its token, provider, account_identifier, status, workspace_tokens, and created_at. Requires a JSON request body per the createCustomProviderIntegration schema. Required: name.
- **delete_a_vantage_integration_cost_by_id** — Delete a user costs upload from a Vantage integration by id. Returns an empty 204 response on success. Required: id, integration_token.
- **list_all_vantage_integration_costs** — List user costs uploads for a Vantage integration. Returns each upload's token, filename, amount, start_date, end_date, import_status, created_by_token, and created_at. Required: integration_token.
- **create_a_vantage_integration_cost** — Upload a CSV of custom provider costs to a Vantage Custom Provider Integration, creating a UserCostsUpload. Returns: token, filename, amount, start_date, end_date, import_status, created_by_token, created_at. Set auto_transform to convert the CSV to FOCUS format (defaults to false); imports process asynchronously. Required: integration_token.
- **create_a_vantage_integrations_gcp** — Create a GCP integration in Vantage. Returns the created integration with its token, provider, account_identifier, status, created_at, workspace_tokens, last_updated, managed_account_tokens, and enriched_by. Requires a JSON request body (createGCPIntegration schema). Required: billing_account_id, project_id, dataset_name.
- **create_a_vantage_integrations_azure** — Create an Azure cost integration in Vantage. Requires a JSON request body. Returns the created integration including its token, provider, account_identifier, status, workspace_tokens, and created_at. Required: tenant, app_id, password.
- **create_a_vantage_integrations_twilio** — Create a Twilio integration in Vantage to start importing Twilio cost data. Returns the created integration with token, provider, account_identifier, status, created_at, last_updated, workspace_tokens, managed_account_tokens, and enriched_by. Requires a JSON request body; its fields are defined by the upstream createTwilioIntegration schema. Required: api_key, api_secret, account_sid, friendly_account_name, description.
- **list_all_vantage_invoices** — List Vantage invoices. Returns invoice records including their id. Max 1000 per page. Requires MSP invoicing; supports managed_account_token to filter by managed account (MSP accounts only).
- **create_a_vantage_invoice** — Create an invoice in Vantage (MSP accounts only). Returns the created invoice object including its invoice_token; other fields follow Vantage's Invoice schema and are not enumerated in the available docs. Requires a JSON request body following Vantage's createInvoice schema. Required: billing_period_start, billing_period_end, account_token.
- **get_single_vantage_invoice_by_id** — Get a single Vantage invoice by id (the invoice token). Returns the invoice object including its invoice_token; other fields follow Vantage's Invoice schema and are not enumerated in the available docs. Required: id.
- **vantage_invoices_send** — Send a Vantage invoice via email. Returns the send-confirmation object defined by Vantage's SendInvoice schema; its individual fields are not enumerated in the available docs. Required: invoice_token.
- **create_a_vantage_invoice_download** — Request a download of a Vantage invoice file (PDF or CSV) and get back the URL for fetching it. Returns: download_url. Required: invoice_token, file_type.
- **create_a_vantage_invoice_send_and_approve** — Send and approve a Vantage invoice via email (MSP accounts only). Returns a confirmation that the invoice was approved and sent successfully. Required: invoice_token.
- **get_single_vantage_invoice_cost_report_by_id** — Get the cost report URL for a Vantage invoice period. Returns the cost report URL object for the invoice period; its field-level shape is not documented upstream. Required: id.
- **create_a_vantage_invoice_regenerate** — Regenerate an existing invoice in Vantage (MSP accounts only); the API starts the regeneration and returns the invoice object, including its id and the upstream Invoice attributes. Required: invoice_token.
- **list_all_vantage_kubernetes_efficiency_reports** — List all Kubernetes efficiency reports in Vantage. Returns each report's token, title, workspace_token, created_at, start_date/end_date, date_interval, date_bucket, aggregated_by, and groupings. Max 1000 per page.
- **create_a_vantage_kubernetes_efficiency_report** — Create a Kubernetes efficiency report in Vantage. Returns the created report including token, title, workspace_token, filter, start_date/end_date, date_interval, date_bucket, aggregated_by, and groupings. Required: workspace_token, title.
- **get_single_vantage_kubernetes_efficiency_report_by_id** — Get a single Kubernetes efficiency report in Vantage by id. Returns: token, title, created_at, workspace_token, user_token, start_date, end_date, date_interval, date_bucket, aggregated_by, groupings, filter.g. kbnts_eff_rprt_...). Required: id.
- **update_a_vantage_kubernetes_efficiency_report_by_id** — Update a Kubernetes efficiency report in Vantage by id. Returns the updated report including token, title, workspace_token, created_at, start_date, end_date, date_interval, date_bucket, aggregated_by, and groupings. Required: id.
- **delete_a_vantage_kubernetes_efficiency_report_by_id** — Delete a Kubernetes efficiency report in Vantage by id. Returns an empty 204 response on success. Required: id.
- **create_a_vantage_kubernetes_efficiency_reports_data_export** — Generate a Kubernetes efficiency data export in vantage. Queues an asynchronous export of Kubernetes efficiency data and returns a DataExport object including token, status, created_at, export_type, and manifest with the download file URLs. Requires a JSON request body.
- **list_all_vantage_kubernetes_efficiency_report_costs** — List cost rows for a Kubernetes efficiency report in vantage, with optional date range, date bin, groupings, VQL filter, and sort order. Returns: accrued_at, amount, idle_cost, cost_efficiency, currency, cluster_id, namespace, region, category, pod, labeled, labels, provider, account_id, service. Max 2500 rows per page. Required: kubernetes_efficiency_report_token.
- **list_all_vantage_managed_accounts** — List all managed accounts in Vantage. Returns each account's token, name, contact_email, parent_account_token, access_credential_tokens, billing_rule_tokens, and email_domain. Max 1000 per page.
- **create_a_vantage_managed_account** — Create a managed account in Vantage. Returns: token, name, contact_email, parent_account_token, access_credential_tokens, billing_rule_tokens, email_domain, msp_billing_profile_token, payment_terms_days, include_managed_account_integrations, billing_information_attributes, business_information_attributes. Requires name, contact_email, and parent_account_token. Required: name, contact_email.
- **get_single_vantage_managed_account_by_id** — Get a single Vantage managed account by id (its token, e.g. acct_d3f99e1941a01861). Returns: token, name, contact_email, parent_account_token, access_credential_tokens, billing_rule_tokens, email_domain, msp_billing_profile_token, payment_terms_days, include_managed_account_integrations, billing_information_attributes, business_information_attributes. Required: id.
- **update_a_vantage_managed_account_by_id** — Update a Vantage managed account by id (its token, e.g. acct_dd2fdf6564b60319). Returns: token, name, contact_email, parent_account_token, access_credential_tokens, billing_rule_tokens, email_domain, msp_billing_profile_token, payment_terms_days, include_managed_account_integrations, billing_information_attributes, business_information_attributes. Required: id.
- **delete_a_vantage_managed_account_by_id** — Delete a Vantage managed account by id (its token, e.g. acct_d3f99e1941a01861). Returns an empty 204 response on success. Required: id.
- **create_a_vantage_managed_account_sso_connection** — Create an SSO connection for a Vantage managed account. Returns the managed account with its token, name, contact_email, parent_account_token, access_credential_tokens, billing_rule_tokens, and email_domain. Requires managed_account_token and an SSO connection configuration body. Required: managed_account_token, type.
- **vantage_managed_account_sso_connections_bulk_update** — Update the SSO configuration for a Vantage managed account. Returns the updated managed account with its token, name, contact_email, parent_account_token, access_credential_tokens, billing_rule_tokens, and email_domain. Requires managed_account_token and an SSO connection configuration body. Required: managed_account_token.
- **vantage_managed_account_sso_connections_bulk_delete** — Delete the SSO connection configured for a Vantage managed account. Returns an empty 204 response on success. Requires managed_account_token. Required: managed_account_token.
- **update_a_vantage_managed_account_integration_by_id** — Update a managed account integration in vantage by replacing the provider account identifiers the delegated Integration imports. Returns: access_credential_token, provider, provider_account_identifiers. An empty provider_account_identifiers array applies no filter; identifiers are only accepted for Azure CSP today (Azure…. Required: id, managed_account_token, provider_account_identifiers.
- **get_single_vantage_managed_account_integration_by_id** — Get the Integration delegated to a vantage Managed Account from the Access Credential named by id. Returns: access_credential_token, provider, provider_account_identifiers, token, account_identifier, status, last_updated, workspace_tokens, created_at, managed_account_tokens, enriched_by. The Access Credential must first be delegated to the Managed Account…. Required: id, managed_account_token.
- **list_all_vantage_me** — Get information about the authenticated Vantage user (the BearerToken's owner). Returns the Me object defined by the Vantage API schema; the API reference does not enumerate its individual fields. No required parameters.
- **vantage_me_bulk_update** — Update the authenticated Vantage user. Requires a JSON request body conforming to the upstream updateMe schema (the API reference does not enumerate its fields). Returns the updated Me object; its individual fields are not enumerated in the API reference.
- **list_all_vantage_cost_providers** — List the connected CostProviders available to query in a Vantage Workspace. Returns each provider's key and name. workspace_token is required when your API token is associated with multiple Workspaces.
- **list_all_vantage_cost_services** — List the CostServices available to query in a Vantage Workspace via VQL. Returns each service's id and its upstream attributes (the CostService field set is defined in VQL). Pass workspace_token if the API token is associated with multiple Workspaces.
- **create_a_vantage_user_feedback** — Submit user feedback to Vantage about its product and features. Returns the created UserFeedback record with its id plus vendor-defined attributes. Requires a JSON request body following Vantage's createUserFeedback schema. Required: message.
- **list_all_vantage_network_flow_logs** — List aggregated Network Flow Logs in Vantage, either for a saved network flow report (network_flow_report_token) or via an ad hoc VQL filter. Returns: groupings, bytes, estimated_cost, currency, sampled_bytes, sampled_estimated_cost. Max 1000 per page.
- **list_all_vantage_network_flow_reports** — List vantage network flow reports. Returns each report's token, title, created_at, start/end dates, date_interval, groupings, flow_direction, flow_weight, filter, and workspace_token. Max 1000 results per page.
- **create_a_vantage_network_flow_report** — Create a vantage network flow report. Returns the created report's token, title, created_at, start/end dates, date_interval, groupings, flow_direction, flow_weight, filter, and workspace_token. Required: workspace_token, title.
- **get_single_vantage_network_flow_report_by_id** — Get a vantage network flow report by id. Returns the report's token, title, created_at, start/end dates, date_interval, groupings, flow_direction, flow_weight, filter, and workspace_token. Required: id.
- **update_a_vantage_network_flow_report_by_id** — Update a vantage network flow report by id. Returns the updated report's token, title, created_at, start/end dates, date_interval, groupings, flow_direction, flow_weight, filter, and workspace_token. Required: id.
- **delete_a_vantage_network_flow_report_by_id** — Delete a vantage network flow report by id. Returns an empty 204 response on success. Required: id.
- **list_all_vantage_product_prices** — List available prices across all regions for a product in Vantage. Returns: id, unit, region, rate_type, currency, amount, details. Max 1000 results per page. Required: product_id.
- **get_single_vantage_product_price_by_id** — Get a single price by id for a product in Vantage. Returns the full price object with its id, unit, region, rate_type, currency, amount, and details. Required: id, product_id.
- **list_all_vantage_products** — List all available vantage products, such as every EC2 instance type for a provider and service. Returns: id, category, name, service_id, provider_id, details. Filterable by provider_id, service_id, or name. Max 1000 per page.
- **get_single_vantage_product_by_id** — Get a single vantage product by id. Returns: id, category, name, service_id, provider_id, details. Required: id.
- **list_all_vantage_recommendations** — List Vantage cost recommendations. Returns: token, type, category, workspace_token, provider, provider_account_id, description, documentation_url, potential_savings, service, created_at, resources_affected_count, currency_code, currency_symbol. Filter by workspace_token, provider, status, type, min_savings, and more. Max 1000 per page.
- **get_single_vantage_recommendation_by_id** — Get a single Vantage recommendation by its id (recommendation token). Returns: token, type, category, workspace_token, provider, provider_account_id, description, documentation_url, potential_savings, service, created_at, resources_affected_count, currency_code, currency_symbol. Required: id.
- **list_all_vantage_recommendation_resources** — List all Active Resources, including recommendation actions, referenced in a Vantage recommendation. Returns: links, resources. Max 500 per page. Required: recommendation_token.
- **get_single_vantage_recommendation_resource_by_id** — Get a single Active Resource, including its recommendation actions, referenced in a Vantage recommendation. Returns: token, uuid, type, label, metadata, account_id, billing_account_id, provider, region, costs, created_at, tags, resource_id, recommendation_actions. Required: id, recommendation_token.
- **list_all_vantage_by_type_resources** — List all active resources associated with recommendations of the specified type in Vantage. Returns: token, uuid, type, label, metadata, account_id, billing_account_id, provider, region, costs, created_at, tags, resource_id, recommendation_actions, cost. Max 1000 per page. Required: type, workspace_token.
- **list_all_vantage_recommendation_views** — List recommendation views in Vantage, optionally filtered by workspace or searched by title. Returns: token, title, workspace_token, start_date, end_date, provider_ids, billing_account_ids, account_ids, regions, types, tag_key, tag_value, min_savings, created_at, created_by. Max 1000 results per page.
- **create_a_vantage_recommendation_view** — Create a recommendation view in Vantage scoped to a workspace, date range, and optional provider/account/region and tag filters. Returns the created view including token, title, workspace_token, start_date, end_date, and created_at. Requires title and workspace_token. Required: title, workspace_token.
- **get_single_vantage_recommendation_view_by_id** — Get a single recommendation view in Vantage by its token id. Returns: token, title, workspace_token, start_date, end_date, provider_ids, billing_account_ids, account_ids, regions, types, tag_key, tag_value, min_savings, created_at, created_by. Required: id.
- **update_a_vantage_recommendation_view_by_id** — Update a recommendation view in Vantage by id — change its title, date range, or filters. Returns the updated view including token, title, workspace_token, start_date, end_date, and created_at. Required: id.
- **delete_a_vantage_recommendation_view_by_id** — Delete a recommendation view in Vantage by its token id. Returns an empty 204 response on success. Required: id.
- **list_all_vantage_report_notifications** — List all Vantage report notifications. Returns: token, title, cost_report_token, user_tokens, recipient_emails, recipient_channels, frequency, change. Optionally filter by workspace_token or search by title with q.
- **create_a_vantage_report_notification** — Create a Vantage report notification for a Cost Report. Returns the created notification including token, title, cost_report_token, user_tokens, frequency, and change. Required: title, cost_report_token, frequency, change.
- **get_single_vantage_report_notification_by_id** — Get a single Vantage report notification by its token. Returns: token, title, cost_report_token, user_tokens, recipient_emails, recipient_channels, frequency, change. Required: id.
- **update_a_vantage_report_notification_by_id** — Update a Vantage report notification by its token. Returns the updated notification including token, title, cost_report_token, user_tokens, frequency, and change. Required: id.
- **delete_a_vantage_report_notification_by_id** — Delete a Vantage report notification by its token. Returns an empty 204 response on success. Required: id.
- **list_all_vantage_report_forecasts** — List all scenario-model ReportForecasts for a CostReport in Vantage. Returns each forecast's token, title, cost_report_token, scenario_model_tokens, and is_default. Required: cost_report_token.
- **create_a_vantage_report_forecast** — Create a scenario-model ReportForecast in Vantage. Returns the created forecast including token, title, cost_report_token, scenario_model_tokens, and is_default. Required: cost_report_token, title.
- **get_single_vantage_report_forecast_by_id** — Get a single scenario-model ReportForecast by id in Vantage. Returns: token, title, cost_report_token, scenario_model_tokens, business_metric_token, is_default, created_by_token, created_at, updated_at. Required: id.
- **update_a_vantage_report_forecast_by_id** — Update a scenario-model ReportForecast in Vantage by id. Returns the updated forecast including token, title, cost_report_token, scenario_model_tokens, and is_default. Required: id.
- **delete_a_vantage_report_forecast_by_id** — Delete a scenario-model ReportForecast by id in Vantage. Returns an empty 204 response on success. Required: id.
- **list_all_vantage_resource_reports_columns** — List the available column names for a resource report type in Vantage. Returns: columns.g. provider, label, accruedCosts, recommendationSavings, instanceType, state, name, tags). Required: resource_type.
- **list_all_vantage_resource_reports** — List all Vantage resource reports, optionally filtered by workspace or searched by title. Returns: token, title, filter, created_at, workspace_token, user_token, created_by_token, folder_token, columns. Max 1000 per page.
- **create_a_vantage_resource_report** — Create a Vantage resource report that selects provider resources via a VQL filter expression. Returns the created report including token, title, filter, columns, workspace_token, and created_at. Required: workspace_token.
- **get_single_vantage_resource_report_by_id** — Get a single Vantage resource report by id (the resource report token). Returns: token, title, filter, created_at, workspace_token, user_token, created_by_token, folder_token, columns. Required: id.
- **update_a_vantage_resource_report_by_id** — Update a Vantage resource report by id, changing its title, VQL filter, or displayed columns. Returns the updated report including token, title, filter, columns, workspace_token, and created_at. Required: id.
- **delete_a_vantage_resource_report_by_id** — Delete a Vantage resource report by id. Returns an empty 204 response on success. Required: id.
- **list_all_vantage_resources** — List vantage resources contained in a resource report, optionally filtered with the VQL filter language. Returns: token, uuid, type, label, metadata, account_id, billing_account_id, provider, region, costs, created_at, tags, cost.
- **get_single_vantage_resource_by_id** — Get a single vantage resource by id (its resource token, e.g. prvdr_rsrc_4a1f4a30d86a586f). Returns: token, uuid, type, label, metadata, account_id, billing_account_id, provider, region, costs, created_at, tags. Required: id.
- **list_all_vantage_saved_filters** — List saved filters in Vantage that can be applied to Cost Reports. Returns: token, title, cost_report_tokens, filter, created_at, created_by, workspace_token.
- **create_a_vantage_saved_filter** — Create a saved filter for Cost Reports in Vantage. Returns the created filter including token, title, filter, cost_report_tokens, created_at, and workspace_token. Required: title.
- **get_single_vantage_saved_filter_by_id** — Get a single saved filter in Vantage by its token. Returns: token, title, cost_report_tokens, filter, created_at, created_by, workspace_token. Required: id.
- **update_a_vantage_saved_filter_by_id** — Update a saved filter for Cost Reports in Vantage by id. Returns the updated filter including token, title, filter, cost_report_tokens, created_at, and workspace_token. Required: id.
- **delete_a_vantage_saved_filter_by_id** — Delete a saved filter from Vantage by id. Returns an empty 204 response on success. Required: id.
- **list_all_vantage_scenario_models** — List all scenario models in vantage. Returns each model's token, title, priority, periods, created_by_token, created_at, and updated_at.
- **create_a_vantage_scenario_model** — Create a scenario model in vantage. Returns the created model's token, title, priority, periods, created_by_token, created_at, and updated_at. Required: title.
- **get_single_vantage_scenario_model_by_id** — Get a single scenario model in vantage by id (the scenario model token from a list response, e.g. frcst_mdl_...). Returns: token, title, priority, workspace_token, provider, service, periods, created_by_token, created_at, updated_at. Required: id.
- **update_a_vantage_scenario_model_by_id** — Update a scenario model in vantage by id (the scenario model token from a list response, e.g. frcst_mdl_...). Returns the updated model including token, title, priority, periods, created_at, and updated_at. Required: id.
- **delete_a_vantage_scenario_model_by_id** — Delete a scenario model in vantage by id (the scenario model token from a list response, e.g. frcst_mdl_...). Returns an empty 204 response on success. Required: id.
- **list_all_vantage_segments** — List all Vantage segments. Returns each segment's token, title, description, filter, priority, report_settings, created_at, workspace_token, and report_token. Filter results with q (search by title) and workspace_token; maximum page size is 1000.
- **create_a_vantage_segment** — Create a new Vantage segment. Returns the created segment including token, title, parent_segment_token, filter, priority, created_at, workspace_token, and report_token. Required: title.
- **get_single_vantage_segment_by_id** — Get a single Vantage segment by id (its segment token). Returns: token, title, parent_segment_token, description, track_unallocated, report_settings, priority, filter, created_at, workspace_token, report_token. Required: id.
- **update_a_vantage_segment_by_id** — Update an existing Vantage segment by id (its segment token). Returns the updated segment including token, title, parent_segment_token, filter, priority, created_at, workspace_token, and report_token. Required: id.
- **delete_a_vantage_segment_by_id** — Delete a Vantage segment by id (its segment token). Returns an empty 204 response on success. Required: id.
- **list_all_vantage_tags** — List all Tags in Vantage that the current API token has access to. Returns: tag_key, hidden, preferred, providers. Max 1000 per page.
- **vantage_tags_bulk_update** — Update an existing Tag in Vantage, such as toggling whether it is hidden or preferred. Returns: tag_key, hidden, preferred, providers.
- **list_all_vantage_tag_values** — List the distinct values recorded for a tag in Vantage for a given tag key. Returns: tag_value, providers. Max 1000 results per page. Required: key.
- **list_all_vantage_teams** — List all Vantage Teams the current API token has access to. Returns: token, name, description, workspace_tokens, user_emails, user_tokens, default_dashboard_token. Supports name search via q and filtering by workspace_token. Max 1000 per page.
- **create_a_vantage_team** — Create a Vantage Team. Returns the created team with token, name, description, workspace_tokens, user_tokens, and default_dashboard_token. Required: name.
- **get_single_vantage_team_by_id** — Get a single Vantage Team by id (the team token, e.g. team_081e09bbb812d369). Returns: token, name, description, workspace_tokens, user_emails, user_tokens, default_dashboard_token. Required: id.
- **update_a_vantage_team_by_id** — Update a Vantage Team by id. Returns the updated team with token, name, description, workspace_tokens, user_tokens, and default_dashboard_token. Required: id.
- **delete_a_vantage_team_by_id** — Delete a Vantage Team by id. Returns an empty 204 response on success. Required: id.
- **delete_a_vantage_team_member_by_id** — Remove a member from a Vantage team. Returns an empty 204 response on success. Required: id, team_token.
- **list_all_vantage_team_members** — List all members of a Vantage team. Returns each member's name, email, user_token, and role. Required: team_token.
- **create_a_vantage_team_member** — Add a member to a Vantage team by email. Returns the added member with name, email, user_token, and role. Required: team_token, user_email, role.
- **create_a_vantage_unit_costs_data_export** — Queue a unit costs data export in Vantage. Returns the queued DataExport including token, status, created_at, export_type, manifest, and attributes; processing is asynchronous, and the manifest's file download URLs are populated once the export completes. Requires a JSON body. Required: cost_report_token.
- **list_all_vantage_unit_costs** — List unit costs for a cost report in Vantage, optionally filtered by date range and binned by day, week, month, quarter, or hour. Returns: links, business_metric_token, business_metric_title, calculation_type, unit_cost_amount, business_metric_amount, scale, date. Max 1000 results per page. Required: cost_report_token.
- **list_all_vantage_users** — List all Vantage users the current API token has access to. Returns each user's token, name, email, role, and last_seen_at. Max 1000 per page.
- **get_single_vantage_user_by_id** — Get a specific Vantage user by id (the user's token). Returns the full user object including token, name, email, role, and last_seen_at. Required: id.
- **update_a_vantage_user_by_id** — Update a specific Vantage user by id (the user's token). Returns the updated user object including token, name, email, role, and last_seen_at. Required: id.
- **list_all_vantage_virtual_tag_configs** — List all Virtual Tag Configs in Vantage that the current API token can access. Returns: token, created_by_token, key, hidden, preferred, overridable, backfill_until, collapsed_tag_keys, values. Accepts q to filter by key.
- **create_a_vantage_virtual_tag_config** — Create a new Virtual Tag Config in Vantage. Returns the created config with token, key, overridable, backfill_until, and its values. Requires key; each value carries a VQL filter and name. Required: key, overridable.
- **get_single_vantage_virtual_tag_config_by_id** — Get a single Virtual Tag Config in Vantage by its token. Returns: token, created_by_token, key, hidden, preferred, overridable, backfill_until, collapsed_tag_keys, values. Required: id.
- **update_a_vantage_virtual_tag_config_by_id** — Update an existing virtual tag config in Vantage, identified by its token (vtag_...). Returns the updated VirtualTagConfig including token, key, overridable, backfill_until, collapsed_tag_keys, and the values array (each with filter, name, date_ranges). Required: id.
- **delete_a_vantage_virtual_tag_config_by_id** — Delete an existing virtual tag config in Vantage by id (its vtag_... token). Returns an empty 204 response on success. Required: id.
- **get_single_vantage_virtual_tag_config_status_by_id** — Get the processing status of a specific Virtual Tag Config in Vantage. Returns: token, processing, providers.g. processing, complete).g. vtag_1234). Required: id.
- **vantage_virtual_tag_config_asyncs_bulk_update** — Update an existing Vantage virtual tag config asynchronously by token. Returns a 202 'Request accepted for processing' acknowledgement whose payload shape is not enumerated in the Vantage docs. Required: virtual_tag_config_token.
- **get_single_vantage_virtual_tag_configs_async_by_id** — Get the status of an async VirtualTagConfig update in Vantage. Returns: token, processing, providers. Required: id.
- **create_a_vantage_virtual_tag_config_value** — Create a VirtualTagConfigValue under a virtual tag config in Vantage. Returns the created value with its token, filter, name, label_transforms, percentages, and date_ranges. Required: virtual_tag_config_token, filter.
- **update_a_vantage_virtual_tag_config_value_by_id** — Update a VirtualTagConfigValue by id within a virtual tag config in Vantage. Returns the updated value including token, filter, name, label_transforms, percentages, and date_ranges. Required: id, virtual_tag_config_token.
- **delete_a_vantage_virtual_tag_config_value_by_id** — Delete a VirtualTagConfigValue by id from a virtual tag config in Vantage. Returns an empty 204 response on success. Required: id, virtual_tag_config_token.
- **get_single_vantage_virtual_tag_config_value_by_id** — Get a VirtualTagConfigValue by id within a virtual tag config in Vantage. Returns the value's token, filter, name, label_transforms, percentages, and date_ranges. Required: id, virtual_tag_config_token.
- **list_all_vantage_workspaces** — List Vantage workspaces the current API token can access. Returns: token, name, created_at, enable_currency_conversion, currency, exchange_rate_date.
- **create_a_vantage_workspace** — Create a Vantage workspace. Returns the created workspace object with token, name, created_at, currency, enable_currency_conversion, and exchange_rate_date. Required: name.
- **get_single_vantage_workspace_by_id** — Get a single Vantage workspace by id (its workspace token). Returns: token, name, created_at, enable_currency_conversion, currency, exchange_rate_date. Required: id.
- **update_a_vantage_workspace_by_id** — Update a Vantage workspace by id (its workspace token). Returns the updated workspace object with token, name, created_at, currency, enable_currency_conversion, and exchange_rate_date. Required: id.
- **delete_a_vantage_workspace_by_id** — Delete a Vantage workspace by id (its workspace token). Returns an empty 204 response on success. Required: id.
- **list_all_vantage_pings** — Check the health of the Vantage API to determine whether it is running smoothly. Returns an empty 200 response on success.
- **list_all_vantage_oas_v_3_s** — Get the OpenAPI 3.0.1 specification document for Vantage's API. Returns the compliant spec document including its openapi version, info, paths, and components — usable for generating client libraries or exploring the API in Swagger UI or Postman. Takes no parameters.

## How it works

1. **Link your customer's Vantage account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app.
2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request.
3. **Call Truto's API to reach Vantage.** The Proxy API is a 1-to-1 mapping of the Vantage API.
4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field.

## Use cases

- **Embed cloud cost visibility inside developer portals** — Internal developer platforms and service catalogs can offer a native Vantage connection so engineers see live infrastructure spend for the services they own, without leaving the portal.
- **Power unit economics for usage-based billing products** — Metering and billing platforms can push product usage data into their customers' Vantage accounts to automatically produce cost-per-transaction, cost-per-user, or cost-per-API-call metrics tied to real cloud spend.
- **Automate FinOps recommendations into engineering workflows** — Project management and ITSM tools can pull Vantage's rightsizing and idle-resource recommendations and turn them into trackable tickets, closing the loop between cost findings and engineering execution.
- **Sync cloud invoices into finance and ERP systems** — Accounting, spend management, and ERP platforms can pull Vantage invoices and cost reports to automate cloud chargebacks, GL mapping, and amortized cost reconciliation each month.
- **Enable MSPs to manage sub-tenant billing programmatically** — Reseller and MSP platforms can provision Vantage managed accounts, apply billing rules with markups or discounts, and distribute generated invoices to end customers automatically.

## What you can build

- **Live cost widgets scoped by VQL or segment** — Render per-service, per-team, or per-environment spend inside your UI by querying scoped costs and cost reports from a connected Vantage workspace.
- **Scheduled business metric uploads for unit costs** — Push daily active users, transactions, or token counts into Vantage via bulk business metric updates so joint customers can compute unit costs against infrastructure spend.
- **Recommendation-to-ticket automation** — Fetch Vantage recommendations and their underlying resources, then create tickets in your product with the exact savings estimate and resource identifier needed to action them.
- **Budget and anomaly alert routing** — Create and manage Vantage budgets, budget alerts, and anomaly notifications from inside your app so users can configure cost guardrails without context switching.
- **Automated invoice and cost report delivery** — Generate and retrieve Vantage invoices and cost report exports on a schedule to deliver cloud chargebacks, PDFs, or CSVs into accounting systems or customer portals.
- **MSP tenant provisioning flows** — Create managed accounts, attach billing rules, and manage integrations per sub-tenant so resellers can onboard new customers end-to-end from your platform.

## FAQs

### How do end users authenticate their Vantage account?

Vantage uses API token-based authentication. Truto handles token collection, encrypted storage, and injection on each request so your end users complete a standard connect flow and your app never touches the credential directly.

### Can we pull cost data filtered by tag, provider, or environment?

Yes. The costs and cost reports endpoints support Vantage Query Language (VQL) filters, so you can query accrued costs scoped to specific tags, providers, services, or custom segments without ingesting raw billing data.

### How do we push external usage data to compute unit costs?

You can create a business metric in the user's Vantage workspace and then push values in bulk on a schedule. Vantage joins those metric values with cost reports to expose unit costs through its unit costs endpoint.

### What's the data freshness for costs and recommendations?

Vantage ingests billing data from providers on their native cadence (typically daily for most clouds). Truto proxies calls in real time, so whenever you list costs or recommendations you receive the latest state Vantage has processed from upstream providers.

### Does the integration support MSP and multi-tenant workflows?

Yes. You can list, create, update, and delete managed accounts, manage their SSO connections and integrations, apply billing rules, and retrieve invoices per sub-tenant, which covers the full reseller lifecycle.

### How does pagination and rate limiting work through Truto?

Truto normalizes Vantage's cursor-based pagination so list endpoints return consistent page tokens, and automatically handles retries and backoff for upstream rate limits so your integration code stays simple.
