Operations about AnomalyNotifications
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/vantage-sh:vantage-sh-anomalynotifications-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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: 3.2.0
info:
title: Vantage Anomaly Notifications API
description: The Vantage API provides programmatic access to the Vantage cloud cost management and FinOps platform.
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:
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.
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.
AnomalyNotifications:
required:
- anomaly_notifications
type: object
properties:
links:
$ref: '#/components/schemas/Links'
anomaly_notifications:
type: array
items:
$ref: '#/components/schemas/AnomalyNotification'
description: AnomalyNotifications 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.
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
Errors:
required:
- errors
type: object
properties:
links:
$ref: '#/components/schemas/Links'
errors:
type: array
items:
type: string
description: Errors 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'