Skip to main content
PUT
Update virtual tag config

Authorizations

Authorization
string
header
required

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

Scopes

write

Grants write access

Path Parameters

token
string
required

Body

application/json

Updates an existing VirtualTagConfig.

key
string

The key of the VirtualTagConfig.

overridable
boolean | null

Whether the VirtualTagConfig can override a provider-supplied tag on a matching Cost.

backfill
boolean | null

Whether to backfill historical costs for this update. Omit to use the account's automatic-backfill setting. True requests backfill only when the configuration changes, respecting eligibility, date ranges, retention, and provider month locks. False saves without requesting backfill; later refreshes or other backfills may still apply the configuration to unlocked historical costs. backfill_until controls the earliest eligible month, not whether backfill runs.

backfill_until
string<date> | null

The earliest month the VirtualTagConfig should be backfilled to.

collapsed_tag_keys
object[]

Tag keys to collapse values for.

values
object[]

Values for the VirtualTagConfig, with match precedence determined by order in the list.

Response

VirtualTagConfig model

token
string
required

The token of the VirtualTagConfig.

Example:

"vtag_1234"

created_by_token
string | null
required

The token of the Creator of the VirtualTagConfig.

Example:

"usr_1234"

key
string
required

The key of the VirtualTagConfig.

Example:

"Cost Center"

hidden
boolean
required

Whether the VirtualTagConfig key is hidden from the Vantage UI.

preferred
boolean
required

Whether the VirtualTagConfig key is marked as preferred in the Vantage UI.

overridable
boolean
required

Whether the VirtualTagConfig can override a provider-supplied tag on a matching Cost.

backfill_until
string
required

The earliest month VirtualTagConfig should be backfilled to.

Example:

"2026-05-01"

collapsed_tag_keys
object[]
required

Tag keys to collapse values for.

values
object[]
required

Values for the VirtualTagConfig, with match precedence determined by their relative order in the list.