Vantage AnomalyNotifications API

Operations about AnomalyNotifications

Operations 5

GET /anomaly_notifications Get all anomaly notifications #
POST /anomaly_notifications Create anomaly notification #
GET /anomaly_notifications/{anomaly_notification_token} Get anomaly notification by token #
PUT /anomaly_notifications/{anomaly_notification_token} Update anomaly notification #
DELETE /anomaly_notifications/{anomaly_notification_token} Delete anomaly notification #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/vantage-sh-anomalynotifications-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

vantage-sh-anomalynotifications-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Vantage AccessGrants Anomaly Notifications API
  description: The Vantage API provides programmatic access to the Vantage cloud cost management and FinOps platform. It covers cost reporting and querying (Costs, Cost Reports, forecasts, unit costs), cost visibility and optimization (Resources, Recommendations, Financial Commitments, Kubernetes efficiency), governance and alerting (Budgets, Budget Alerts, Cost Alerts, Anomaly Alerts and Notifications), organization (Segments, Folders, Saved Filters, Dashboards, Workspaces, Teams), and billing (Billing Profiles, Billing Rules, Invoices). The API spans AWS, Azure, GCP, Kubernetes, Datadog, Snowflake, MongoDB, and other supported providers. Base URL https://api.vantage.sh/v2. Authentication is via OAuth2 (client credentials / bearer token) with read and write scopes.
  termsOfService: https://www.vantage.sh/terms-of-use
  contact:
    name: Vantage Support
    url: https://www.vantage.sh
    email: support@vantage.sh
  version: 2.0.0
servers:
- url: https://api.vantage.sh/v2
security:
- oauth2:
  - read
tags:
- name: AnomalyNotifications
  description: Operations about AnomalyNotifications
paths:
  /anomaly_notifications:
    get:
      tags:
      - AnomalyNotifications
      summary: Get all anomaly notifications
      description: Return all Anomaly Notifications.
      operationId: getAnomalyNotifications
      parameters:
      - name: page
        in: query
        description: The page of results to return.
        schema:
          type: integer
          format: int32
      - name: limit
        in: query
        description: The amount of results to return. The maximum is 1000.
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnomalyNotifications'
              example:
                links:
                  self: https://api.vantage.sh/v2/anomaly_notifications
                  first: https://api.vantage.sh/v2/anomaly_notifications?page=1
                  next: null
                  last: https://api.vantage.sh/v2/anomaly_notifications?page=1
                  prev: null
                anomaly_notifications:
                - token: rprt_alrt_ecb76d8d2825762f
                  cost_report_token: rprt_45fe4d4c1779ce7e
                  created_at: '2024-04-09T15:05:37Z'
                  updated_at: '2024-04-09T15:05:37Z'
                  threshold: 10
                  user_tokens:
                  - usr_13477ee1b1eb81ba
                  recipient_channels: []
      security:
      - oauth2:
        - read
    post:
      tags:
      - AnomalyNotifications
      summary: Create anomaly notification
      description: Create an Anomaly Notification for a Cost Report.
      operationId: createAnomalyNotification
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/createAnomalyNotification'
        required: true
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnomalyNotification'
              example:
                token: rprt_alrt_9b22edfa0a175609
                cost_report_token: rprt_4c9e5f72ae27bc24
                created_at: '2024-04-09T15:05:37Z'
                updated_at: '2024-04-09T15:05:37Z'
                threshold: 1
                user_tokens:
                - usr_3773d590e84f6f12
                recipient_channels:
                - channel1
                - channel2
        '400':
          description: BadRequest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
      security:
      - oauth2:
        - write
      x-codegen-request-body-name: createAnomalyNotification
  /anomaly_notifications/{anomaly_notification_token}:
    get:
      tags:
      - AnomalyNotifications
      summary: Get anomaly notification by token
      description: Return an Anomaly Notification that the current API token has access to.
      operationId: getAnomalyNotification
      parameters:
      - name: anomaly_notification_token
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnomalyNotification'
              example:
                token: rprt_alrt_5af901100951705b
                cost_report_token: rprt_0d88354748562c26
                created_at: '2024-04-09T15:05:37Z'
                updated_at: '2024-04-09T15:05:37Z'
                threshold: 10
                user_tokens:
                - usr_e163fcb7aeb41f3b
                recipient_channels: []
        '404':
          description: NotFound
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
      security:
      - oauth2:
        - read
    put:
      tags:
      - AnomalyNotifications
      summary: Update anomaly notification
      description: Update an Anomaly Notification.
      operationId: updateAnomalyNotification
      parameters:
      - name: anomaly_notification_token
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/updateAnomalyNotification'
        required: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnomalyNotification'
              example:
                token: rprt_alrt_15da34156dca939d
                cost_report_token: rprt_82320a9c1a608f0f
                created_at: '2024-04-09T15:05:37Z'
                updated_at: '2024-04-09T15:05:37Z'
                threshold: 2
                user_tokens:
                - usr_dff5de2b6aecf042
                recipient_channels:
                - channel3
                - channel4
        '400':
          description: BadRequest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
      security:
      - oauth2:
        - write
      x-codegen-request-body-name: updateAnomalyNotification
    delete:
      tags:
      - AnomalyNotifications
      summary: Delete anomaly notification
      description: Delete an Anomaly Notification.
      operationId: deleteAnomalyNotification
      parameters:
      - name: anomaly_notification_token
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnomalyNotification'
        '404':
          description: NotFound
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
      security:
      - oauth2:
        - write
components:
  schemas:
    Errors:
      required:
      - errors
      type: object
      properties:
        links:
          $ref: '#/components/schemas/Links'
        errors:
          type: array
          items:
            type: string
      description: Errors model
    Links:
      type: object
      properties:
        self:
          type:
          - string
          - 'null'
          description: The URL of the current page of results.
        first:
          type:
          - string
          - 'null'
          description: The URL of the first page of results.
        next:
          type:
          - string
          - 'null'
          description: The URL of the next page of results, if one exists.
        last:
          type:
          - string
          - 'null'
          description: The URL of the last page of results, if one exists.
        prev:
          type:
          - string
          - 'null'
          description: The URL of the previous page of results, if one exists.
    AnomalyNotifications:
      required:
      - anomaly_notifications
      type: object
      properties:
        links:
          $ref: '#/components/schemas/Links'
        anomaly_notifications:
          type: array
          items:
            $ref: '#/components/schemas/AnomalyNotification'
      description: AnomalyNotifications model
    updateAnomalyNotification:
      type: object
      properties:
        threshold:
          type: integer
          description: The threshold amount that must be met for the notification to fire.
          format: int32
        user_tokens:
          type: array
          description: The tokens of the users that receive the notification.
          items:
            type: string
        recipient_channels:
          type: array
          description: The Slack/MS Teams channels that receive the notification.
          items:
            type: string
      description: Update an Anomaly Notification.
    createAnomalyNotification:
      required:
      - cost_report_token
      type: object
      properties:
        cost_report_token:
          type: string
          description: The token of the Cost Report that has the notification.
        threshold:
          type: integer
          description: The threshold amount that must be met for the notification to fire.
          format: int32
        user_tokens:
          type: array
          description: The tokens of the Users that receive the notification.
          items:
            type: string
        recipient_channels:
          type: array
          description: The Slack/MS Teams channels that receive the notification.
          items:
            type: string
      description: Create an Anomaly Notification for a Cost Report.
    AnomalyNotification:
      required:
      - cost_report_token
      - created_at
      - recipient_channels
      - threshold
      - token
      - updated_at
      - user_tokens
      type: object
      properties:
        token:
          type: string
        cost_report_token:
          type: string
          description: The token for the CostReport the AnomalyNotification is associated with.
        created_at:
          type: string
          description: The date and time, in UTC, the AnomalyNotification was created. ISO 8601 Formatted.
          example: '2023-08-04T00:00:00Z'
        updated_at:
          type: string
          description: The date and time, in UTC, the AnomalyNotification was last updated at. ISO 8601 Formatted.
          example: '2023-08-04T00:00:00Z'
        threshold:
          type: integer
          description: The threshold amount that must be met for the notification to fire.
          format: int32
        user_tokens:
          type: array
          description: The tokens of the users that receive the notification.
          items:
            type: string
        recipient_channels:
          type: array
          description: The channels that the notification is sent to.
          items:
            type: string
      description: AnomalyNotification model
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://console.vantage.sh/account/profile
          scopes:
            read: Grants read access
            write: Grants write access
x-original-swagger-version: '2.0'