Vantage Cost Management API

The Vantage Cost Management API (v2) provides programmatic access to cloud cost data and enables automation of cost management workflows. Create and manage Cost Reports, Folders, Dashboards, Saved Filters, Teams, Budgets, Anomaly Alerts, Business Metrics, Network Flow Reports, Financial Commitment Reports, Resource Reports, Segments, Integrations, and more. Supports the Vantage Query Language (VQL) for filtering cost data across multiple cloud providers.

Documentation

Specifications

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/cost-report.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/cost.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/folder.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/dashboard.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/saved-filter.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/workspace.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/team.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/access-grant.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/budget-alert.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/anomaly-alert.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/recommendation.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/segment.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/integration.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/managed-account.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/cost-provider.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/business-metric.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/resource-report.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/resource.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/network-flow-report.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/financial-commitment-report.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/json-schema/kubernetes-efficiency-report.json

Other Resources

OpenAPI Specification

vantage-cost-management-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Vantage Cost Management API
  description: >-
    The Vantage Cost Management API provides programmatic access to cloud cost
    data and enables automation of cost management workflows. You can create and
    manage Cost Reports, Folders, Dashboards, Saved Filters, Teams, Budgets,
    Anomaly Alerts, Business Metrics, Network Flow Reports, Financial Commitment
    Reports, Resource Reports, and more. The API uses the Vantage Query Language
    (VQL) for filtering cloud cost data with a normalized schema across various
    cloud providers. Authentication is performed via Bearer tokens using Vantage
    API tokens.
  version: 2.0.0
  contact:
    name: Vantage Support
    url: https://www.vantage.sh/
  license:
    name: Proprietary
    url: https://www.vantage.sh/terms
  termsOfService: https://www.vantage.sh/terms
servers:
- url: https://api.vantage.sh/v2
  description: Vantage API v2 Production
security:
- bearerAuth: []
tags:
- name: Access Grants
  description: Manage resource access grants for teams.
- name: Anomaly Alerts
  description: Create and manage cost anomaly alerts.
- name: Budget Alerts
  description: Create and manage budget alerts.
- name: Business Metrics
  description: Create, update, and delete business metrics.
- name: Cost Providers
  description: Retrieve available cost providers.
- name: Cost Reports
  description: Create, read, update, and delete Cost Reports.
- name: Costs
  description: Retrieve cost data for Cost Reports or VQL filters.
- name: Dashboards
  description: Create and manage cost dashboards.
- name: Financial Commitment Reports
  description: Create and manage financial commitment reports.
- name: Folders
  description: Manage folders for organizing Cost Reports.
- name: Integrations
  description: Manage cloud provider integrations.
- name: Kubernetes
  description: Manage Kubernetes cost data and efficiency reports.
- name: Managed Accounts
  description: Manage linked cloud provider accounts.
- name: Network Flow Reports
  description: Create and manage network flow reports.
- name: Recommendations
  description: Retrieve cost optimization recommendations.
- name: Resource Reports
  description: Create and manage resource reports.
- name: Resources
  description: Retrieve resource data from reports.
- name: Saved Filters
  description: Manage saved filters for cost data.
- name: Segments
  description: Create, update, and delete cost allocation segments.
- name: Teams
  description: Create and manage teams.
- name: Workspaces
  description: Manage workspaces and workspace access.
paths:
  /cost_reports:
    get:
      operationId: getCostReports
      summary: Vantage Get All Cost Reports
      description: Returns all Cost Reports that the current API token has access to.
      tags:
      - Cost Reports
      parameters:
      - $ref: '#/components/parameters/PageParam'
      - $ref: '#/components/parameters/LimitParam'
      responses:
        '200':
          description: Successful response with a list of Cost Reports.
          content:
            application/json:
              schema:
                type: object
                properties:
                  cost_reports:
                    type: array
                    items:
                      $ref: '#/components/schemas/CostReport'
              examples:
                Getcostreports200Example:
                  summary: Default getCostReports 200 response
                  x-microcks-default: true
                  value:
                    cost_reports:
                    - token: example_value
                      title: Example Title
                      filter: example_value
                      groupings: example_value
                      folder_token: example_value
                      saved_filter_tokens:
                      - {}
                      workspace_token: example_value
                      created_at: '2026-01-15T10:30:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      operationId: createCostReport
      summary: Vantage Create a Cost Report
      description: Creates a new Cost Report.
      tags:
      - Cost Reports
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CostReportInput'
            examples:
              CreatecostreportRequestExample:
                summary: Default createCostReport request
                x-microcks-default: true
                value:
                  title: Example Title
                  filter: example_value
                  groupings: example_value
                  folder_token: example_value
                  saved_filter_tokens:
                  - example_value
                  workspace_token: example_value
      responses:
        '201':
          description: Cost Report created successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CostReport'
              examples:
                Createcostreport201Example:
                  summary: Default createCostReport 201 response
                  x-microcks-default: true
                  value:
                    token: example_value
                    title: Example Title
                    filter: example_value
                    groupings: example_value
                    folder_token: example_value
                    saved_filter_tokens:
                    - example_value
                    workspace_token: example_value
                    created_at: '2026-01-15T10:30:00Z'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /cost_reports/{cost_report_token}:
    get:
      operationId: getCostReport
      summary: Vantage Get a Cost Report
      description: Returns a specific Cost Report by token.
      tags:
      - Cost Reports
      parameters:
      - $ref: '#/components/parameters/CostReportToken'
      responses:
        '200':
          description: Successful response with the Cost Report.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CostReport'
              examples:
                Getcostreport200Example:
                  summary: Default getCostReport 200 response
                  x-microcks-default: true
                  value:
                    token: example_value
                    title: Example Title
                    filter: example_value
                    groupings: example_value
                    folder_token: example_value
                    saved_filter_tokens:
                    - example_value
                    workspace_token: example_value
                    created_at: '2026-01-15T10:30:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      operationId: updateCostReport
      summary: Vantage Update a Cost Report
      description: Updates an existing Cost Report.
      tags:
      - Cost Reports
      parameters:
      - $ref: '#/components/parameters/CostReportToken'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CostReportInput'
            examples:
              UpdatecostreportRequestExample:
                summary: Default updateCostReport request
                x-microcks-default: true
                value:
                  title: Example Title
                  filter: example_value
                  groupings: example_value
                  folder_token: example_value
                  saved_filter_tokens:
                  - example_value
                  workspace_token: example_value
      responses:
        '200':
          description: Cost Report updated successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CostReport'
              examples:
                Updatecostreport200Example:
                  summary: Default updateCostReport 200 response
                  x-microcks-default: true
                  value:
                    token: example_value
                    title: Example Title
                    filter: example_value
                    groupings: example_value
                    folder_token: example_value
                    saved_filter_tokens:
                    - example_value
                    workspace_token: example_value
                    created_at: '2026-01-15T10:30:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      operationId: deleteCostReport
      summary: Vantage Delete a Cost Report
      description: Deletes an existing Cost Report.
      tags:
      - Cost Reports
      parameters:
      - $ref: '#/components/parameters/CostReportToken'
      responses:
        '204':
          description: Cost Report deleted successfully.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /costs:
    get:
      operationId: getCosts
      summary: Vantage Get Costs
      description: >-
        Returns all Costs for a CostReport or VQL filter. You can filter by
        cost_report_token or provide a VQL query to retrieve specific cost data.
      tags:
      - Costs
      parameters:
      - name: cost_report_token
        in: query
        description: The token of the Cost Report to retrieve costs for.
        schema:
          type: string
        example: example_value
      - name: start_date
        in: query
        description: The start date for the cost data (YYYY-MM-DD).
        schema:
          type: string
          format: date
        example: '2026-01-15'
      - name: end_date
        in: query
        description: The end date for the cost data (YYYY-MM-DD).
        schema:
          type: string
          format: date
        example: '2026-01-15'
      - name: groupings
        in: query
        description: Comma-separated list of groupings for cost data.
        schema:
          type: string
        example: example_value
      - name: vql
        in: query
        description: A VQL filter expression to query cost data.
        schema:
          type: string
        example: example_value
      - $ref: '#/components/parameters/PageParam'
      - $ref: '#/components/parameters/LimitParam'
      responses:
        '200':
          description: Successful response with cost data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  costs:
                    type: array
                    items:
                      $ref: '#/components/schemas/Cost'
              examples:
                Getcosts200Example:
                  summary: Default getCosts 200 response
                  x-microcks-default: true
                  value:
                    costs:
                    - date: '2026-01-15'
                      amount: example_value
                      currency: example_value
                      provider: example_value
                      service: example_value
                      account_id: '500123'
                      region: example_value
                      category: example_value
                      subcategory: example_value
        '401':
          $ref: '#/components/responses/Unauthorized'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /folders:
    get:
      operationId: getFolders
      summary: Vantage Get All Folders
      description: Returns all Folders that the current API token has access to.
      tags:
      - Folders
      parameters:
      - $ref: '#/components/parameters/PageParam'
      - $ref: '#/components/parameters/LimitParam'
      responses:
        '200':
          description: Successful response with a list of Folders.
          content:
            application/json:
              schema:
                type: object
                properties:
                  folders:
                    type: array
                    items:
                      $ref: '#/components/schemas/Folder'
              examples:
                Getfolders200Example:
                  summary: Default getFolders 200 response
                  x-microcks-default: true
                  value:
                    folders:
                    - token: example_value
                      title: Example Title
                      parent_folder_token: example_value
                      workspace_token: example_value
                      created_at: '2026-01-15T10:30:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      operationId: createFolder
      summary: Vantage Create a Folder
      description: Creates a new Folder for organizing Cost Reports.
      tags:
      - Folders
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FolderInput'
            examples:
              CreatefolderRequestExample:
                summary: Default createFolder request
                x-microcks-default: true
                value:
                  title: Example Title
                  parent_folder_token: example_value
                  workspace_token: example_value
      responses:
        '201':
          description: Folder created successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Folder'
              examples:
                Createfolder201Example:
                  summary: Default createFolder 201 response
                  x-microcks-default: true
                  value:
                    token: example_value
                    title: Example Title
                    parent_folder_token: example_value
                    workspace_token: example_value
                    created_at: '2026-01-15T10:30:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /folders/{folder_token}:
    get:
      operationId: getFolder
      summary: Vantage Get a Folder
      description: Returns a specific Folder by token.
      tags:
      - Folders
      parameters:
      - $ref: '#/components/parameters/FolderToken'
      responses:
        '200':
          description: Successful response with the Folder.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Folder'
              examples:
                Getfolder200Example:
                  summary: Default getFolder 200 response
                  x-microcks-default: true
                  value:
                    token: example_value
                    title: Example Title
                    parent_folder_token: example_value
                    workspace_token: example_value
                    created_at: '2026-01-15T10:30:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      operationId: updateFolder
      summary: Vantage Update a Folder
      description: Updates an existing Folder.
      tags:
      - Folders
      parameters:
      - $ref: '#/components/parameters/FolderToken'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FolderInput'
            examples:
              UpdatefolderRequestExample:
                summary: Default updateFolder request
                x-microcks-default: true
                value:
                  title: Example Title
                  parent_folder_token: example_value
                  workspace_token: example_value
      responses:
        '200':
          description: Folder updated successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Folder'
              examples:
                Updatefolder200Example:
                  summary: Default updateFolder 200 response
                  x-microcks-default: true
                  value:
                    token: example_value
                    title: Example Title
                    parent_folder_token: example_value
                    workspace_token: example_value
                    created_at: '2026-01-15T10:30:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      operationId: deleteFolder
      summary: Vantage Delete a Folder
      description: Deletes an existing Folder.
      tags:
      - Folders
      parameters:
      - $ref: '#/components/parameters/FolderToken'
      responses:
        '204':
          description: Folder deleted successfully.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /dashboards:
    get:
      operationId: getDashboards
      summary: Vantage Get All Dashboards
      description: Returns all Dashboards that the current API token has access to.
      tags:
      - Dashboards
      parameters:
      - $ref: '#/components/parameters/PageParam'
      - $ref: '#/components/parameters/LimitParam'
      responses:
        '200':
          description: Successful response with a list of Dashboards.
          content:
            application/json:
              schema:
                type: object
                properties:
                  dashboards:
                    type: array
                    items:
                      $ref: '#/components/schemas/Dashboard'
              examples:
                Getdashboards200Example:
                  summary: Default getDashboards 200 response
                  x-microcks-default: true
                  value:
                    dashboards:
                    - token: example_value
                      title: Example Title
                      widget_tokens:
                      - {}
                      workspace_token: example_value
                      created_at: '2026-01-15T10:30:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      operationId: createDashboard
      summary: Vantage Create a Dashboard
      description: Creates a new Dashboard.
      tags:
      - Dashboards
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DashboardInput'
            examples:
              CreatedashboardRequestExample:
                summary: Default createDashboard request
                x-microcks-default: true
                value:
                  title: Example Title
                  widget_tokens:
                  - example_value
                  workspace_token: example_value
      responses:
        '201':
          description: Dashboard created successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Dashboard'
              examples:
                Createdashboard201Example:
                  summary: Default createDashboard 201 response
                  x-microcks-default: true
                  value:
                    token: example_value
                    title: Example Title
                    widget_tokens:
                    - example_value
                    workspace_token: example_value
                    created_at: '2026-01-15T10:30:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /dashboards/{dashboard_token}:
    get:
      operationId: getDashboard
      summary: Vantage Get a Dashboard
      description: Returns a specific Dashboard by token.
      tags:
      - Dashboards
      parameters:
      - $ref: '#/components/parameters/DashboardToken'
      responses:
        '200':
          description: Successful response with the Dashboard.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Dashboard'
              examples:
                Getdashboard200Example:
                  summary: Default getDashboard 200 response
                  x-microcks-default: true
                  value:
                    token: example_value
                    title: Example Title
                    widget_tokens:
                    - example_value
                    workspace_token: example_value
                    created_at: '2026-01-15T10:30:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      operationId: updateDashboard
      summary: Vantage Update a Dashboard
      description: Updates an existing Dashboard.
      tags:
      - Dashboards
      parameters:
      - $ref: '#/components/parameters/DashboardToken'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DashboardInput'
            examples:
              UpdatedashboardRequestExample:
                summary: Default updateDashboard request
                x-microcks-default: true
                value:
                  title: Example Title
                  widget_tokens:
                  - example_value
                  workspace_token: example_value
      responses:
        '200':
          description: Dashboard updated successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Dashboard'
              examples:
                Updatedashboard200Example:
                  summary: Default updateDashboard 200 response
                  x-microcks-default: true
                  value:
                    token: example_value
                    title: Example Title
                    widget_tokens:
                    - example_value
                    workspace_token: example_value
                    created_at: '2026-01-15T10:30:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      operationId: deleteDashboard
      summary: Vantage Delete a Dashboard
      description: Deletes an existing Dashboard.
      tags:
      - Dashboards
      parameters:
      - $ref: '#/components/parameters/DashboardToken'
      responses:
        '204':
          description: Dashboard deleted successfully.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /saved_filters:
    get:
      operationId: getSavedFilters
      summary: Vantage Get All Saved Filters
      description: Returns all Saved Filters that the current API token has access to.
      tags:
      - Saved Filters
      parameters:
      - $ref: '#/components/parameters/PageParam'
      - $ref: '#/components/parameters/LimitParam'
      responses:
        '200':
          description: Successful response with a list of Saved Filters.
          content:
            application/json:
              schema:
                type: object
                properties:
                  saved_filters:
                    type: array
                    items:
                      $ref: '#/components/schemas/SavedFilter'
              examples:
                Getsavedfilters200Example:
                  summary: Default getSavedFilters 200 response
                  x-microcks-default: true
                  value:
                    saved_filters:
                    - token: example_value
                      title: Example Title
                      filter: example_value
                      workspace_token: example_value
                      created_at: '2026-01-15T10:30:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      operationId: createSavedFilter
      summary: Vantage Create a Saved Filter
      description: Creates a new Saved Filter.
      tags:
      - Saved Filters
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SavedFilterInput'
            examples:
              CreatesavedfilterRequestExample:
                summary: Default createSavedFilter request
                x-microcks-default: true
                value:
                  title: Example Title
                  filter: example_value
                  workspace_token: example_value
      responses:
        '201':
          description: Saved Filter created successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SavedFilter'
              examples:
                Createsavedfilter201Example:
                  summary: Default createSavedFilter 201 response
                  x-microcks-default: true
                  value:
                    token: example_value
                    title: Example Title
                    filter: example_value
                    workspace_token: example_value
                    created_at: '2026-01-15T10:30:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /saved_filters/{saved_filter_token}:
    get:
      operationId: getSavedFilter
      summary: Vantage Get a Saved Filter
      description: Returns a specific Saved Filter by token.
      tags:
      - Saved Filters
      parameters:
      - $ref: '#/components/parameters/SavedFilterToken'
      responses:
        '200':
          description: Successful response with the Saved Filter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SavedFilter'
              examples:
                Getsavedfilter200Example:
                  summary: Default getSavedFilter 200 response
                  x-microcks-default: true
                  value:
                    token: example_value
                    title: Example Title
                    filter: example_value
                    workspace_token: example_value
                    created_at: '2026-01-15T10:30:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      operationId: updateSavedFilter
      summary: Vantage Update a Saved Filter
      description: Updates an existing Saved Filter.
      tags:
      - Saved Filters
      parameters:
      - $ref: '#/components/parameters/SavedFilterToken'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SavedFilterInput'
            examples:
              UpdatesavedfilterRequestExample:
                summary: Default updateSavedFilter request
                x-microcks-default: true
                value:
                  title: Example Title
                  filter: example_value
                  workspace_token: example_value
      responses:
        '200':
          description: Saved Filter updated successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SavedFilter'
              examples:
                Updatesavedfilter200Example:
                  summary: Default updateSavedFilter 200 response
                  x-microcks-default: true
                  value:
                    token: example_value
                    title: Example Title
                    filter: example_value
                    workspace_token: example_value
                    created_at: '2026-01-15T10:30:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      operationId: deleteSavedFilter
      summary: Vantage Delete a Saved Filter
      description: Deletes an existing Saved Filter.
      tags:
      - Saved Filters
      parameters:
      - $ref: '#/components/parameters/SavedFilterToken'
      responses:
        '204':
          description: Saved Filter deleted successfully.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /workspaces:
    get:
      operationId: getWorkspaces
      summary: Vantage Get All Workspaces
      description: Returns all Workspaces that the current API token has access to.
      tags:
      - Workspaces
      parameters:
      - $ref: '#/components/parameters/PageParam'
      - $ref: '#/components/parameters/LimitParam'
      responses:
        '200':
          description: Successful response with a list of Workspaces.
          content:
            application/json:
              schema:
                type: object
                properties:
                  workspaces:
                    type: array
                    items:
                      $ref: '#/components/schemas/Workspace'
              examples:
                Getworkspaces200Example:
                  summary: Default getWorkspaces 200 response
                  x-microcks-default: true
                  value:
                    workspaces:
                    - token: example_value
                      name: Example Title
                      created_at: '2026-01-15T10:30:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /workspaces/{workspace_token}:
    get:
      operationId: getWorkspace
      summary: Vantage Get a Workspace
      description: Returns a specific Workspace by token.
      tags:
      - Workspaces
      parameters:
      - $ref: '#/components/parameters/WorkspaceToken'
      responses:
        '200':
          description: Successful response with the Workspace.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Workspace'
              examples:
                Getworkspace200Example:
                  summary: Default getWorkspace 200 response
                  x-microcks-default: true
                  value:
                    token: example_value
                    nam

# --- truncated at 32 KB (124 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/vantage/refs/heads/main/openapi/vantage-cost-management-api-openapi.yml