Skip to main content
PUT
/
report_notifications
/
{report_notification_token}
Update report notification
curl --request PUT \
  --url https://api.vantage.sh/v2/report_notifications/{report_notification_token} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "cost_report_token": "<string>",
  "user_tokens": [
    "<string>"
  ],
  "recipient_channels": [
    "<string>"
  ],
  "frequency": "<string>",
  "change": "<string>"
}
'
{
  "token": "rprt_ntfctn_b36b208a90ee87f6",
  "title": "Updated Report Notification",
  "cost_report_token": "rprt_07b88c04aa6bed8c",
  "user_tokens": [
    "usr_35ed19fadcfed8c9"
  ],
  "frequency": "weekly",
  "change": "dollars"
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
report_notification_token
string
required

Body

application/json

Update a ReportNotification.

​
title
string

The title of the ReportNotification.

​
cost_report_token
string

The CostReport token.

​
user_tokens
string[]

The Users that receive the notification.

​
recipient_channels
string[]

The Slack or Microsoft Teams channels that receive the notification.

​
frequency
string

The frequency the ReportNotification is sent. Possible values: daily, weekly, monthly.

​
change
string

The type of change the ReportNotification is tracking. Possible values: percentage, dollars.

Response

ReportNotification model

​
token
string
​
title
string

The title of the ReportNotification.

Example:

"Acme Report Notification"

​
cost_report_token
string

The token for a CostReport the ReportNotification is applied to.

Example:

"rprt_abcd1234"

​
user_tokens
string[]

The Users that receive the notification.

​
recipient_channels
string[]

The Slack or Microsoft Teams channels that receive the notification.

​
frequency
enum<string>

The frequency the ReportNotification is sent.

Available options:
daily,
weekly,
monthly
Example:

"weekly"

​
change
enum<string>

The type of change the ReportNotification is tracking.

Available options:
percentage,
dollars
Example:

"percentage"