Updates a monitored asset.

PUT

/api/v1/provision/admin/monitored-assets/{assetId}

curl --request PUT \
  --url https://example.com/api/v1/provision/admin/monitored-assets/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Content-Type: application/json' \
  --data '{ "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "entitlementId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "productId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "metricName": "example", "name": "example", "description": "example", "unit": "example", "category": "example", "tags": [ "example" ], "numberFormat": "example", "metricType": 1, "meteredUsageId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "meteredUsage": { "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "suspendedUntilAt": "2026-04-15T12:00:00Z", "lastReportedOverageSeverityStatus": 1, "usageTiers": [ { "startUsage": 1, "startPercentage": 1, "endUsage": 1, "endPercentage": 1, "baseCredits": 1, "creditsPerUnitOfConsumption": 1, "name": "example", "quotaUsageLevel": 1, "quotaUsagePolicy": 1 } ], "consumptionPeriod": "example", "accumulationMethod": 1 }, "balanceUsageId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "balanceUsage": { "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "name": "example", "description": "example", "creditsUsed": 1, "totalCredits": 1, "cumulativeCreditsUsed": 1, "unit": "example", "numberFormat": "example", "lastDeposit": "2026-04-15T12:00:00Z", "usageQuota": [ { "endUsage": 1, "name": "example", "quotaUsageLevel": 1 } ], "suspendedUntilAt": "2026-04-15T12:00:00Z", "overageSeverityStatus": 1, "initialCreditAmount": 1, "isUnlimitedCredits": true, "autoBalanceCronSchedule": "example", "lastAutoBalanceDate": "2026-04-15T12:00:00Z", "shouldAutoBalanceTransferCurrentCredits": true, "maxAutoBalanceCreditTransferAmount": 1, "autoBalanceCreditAmount": 1 }, "allowedBackDatingTolerance": "example" }'

Parameters

Path Parameters

assetId

required

string format: uuid

Monitored asset id.

Request Body ^required

Updated payload. Descriptive fields are replaced; omitting the nested allowance/credit-balance does NOT remove them (use the dedicated endpoints for removal).

object

id

string format: uuid

entitlementId

null | string format: uuid

productId

null | string format: uuid

metricName

string

name

string

description

string

unit

string

category

string

tags

Array<string>

numberFormat

string

metricType

integer

meteredUsageId

null | string format: uuid

meteredUsage

One of:

null

null

object

object

id

string format: uuid

suspendedUntilAt

null | string format: date-time

lastReportedOverageSeverityStatus

integer

usageTiers

Array<object>

Represents a tier of usage with associated credits and severity status.

object

startUsage

Gets or sets the start usage for the tier.

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

startPercentage

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

endUsage

Gets or sets the end usage for the tier. Nullable.

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

endPercentage

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

baseCredits

Gets or sets the flat fee credits for the tier.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

creditsPerUnitOfConsumption

Gets or sets the credits per unit of consumption for the tier.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

name

Gets or sets the name of the usage tier.

string

quotaUsageLevel

Gets or sets the overage severity status for the tier.

integer

quotaUsagePolicy

Defines the enforcement behavior applied by the resource controller or interceptor when a specific usage tier threshold is reached. Ordered from least to most restrictive.

integer

consumptionPeriod

string

accumulationMethod

integer

balanceUsageId

null | string format: uuid

balanceUsage

One of:

null

null

object

object

id

string format: uuid

name

string

description

string

creditsUsed

Consumed credits since last deposit. Remaining credits are calculated as TotalCredits - CreditsUsed.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

totalCredits

Total available credits.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

cumulativeCreditsUsed

The total of all credits used over time.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

unit

string

numberFormat

string

lastDeposit

string format: date-time

usageQuota

Array<object>

object

endUsage

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

name

string

quotaUsageLevel

integer

suspendedUntilAt

null | string format: date-time

overageSeverityStatus

integer

initialCreditAmount

The credits available when the entitlement is created.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

isUnlimitedCredits

Indicates if the resource has unlimited credits.

boolean

autoBalanceCronSchedule

Cron schedule for automatic credit balance. The cron syntax consists of five fields separated by spaces:

• Minute (0-59)
• Hour (0-23)
• Day of the Month (1-31)
• Month (1-12 or Jan-Dec)
• Day of the Week (0-6 or Sun-Sat) Special characters:
• • (asterisk): Represents any value for the field.
• , (comma): Separates multiple values.
• • (hyphen): Specifies a range of values.
• / (slash): Specifies increments. Example: “0 0 * * *” means “at midnight every day.”

null | string

lastAutoBalanceDate

Date and time of the last automatic credit balance.

string format: date-time

shouldAutoBalanceTransferCurrentCredits

Indicates if the current credits should be transferred.

boolean

maxAutoBalanceCreditTransferAmount

Maximum amount of credits that can be transferred automatically.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

autoBalanceCreditAmount

Amount of credits to balance automatically.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

allowedBackDatingTolerance

string

/^-?(\d+\.)?\d{2}:\d{2}:\d{2}(\.\d{1,7})?$/

Example ^generated

{
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "entitlementId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "productId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "metricName": "example",
  "name": "example",
  "description": "example",
  "unit": "example",
  "category": "example",
  "tags": [
    "example"
  ],
  "numberFormat": "example",
  "metricType": 1,
  "meteredUsageId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "meteredUsage": {
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "suspendedUntilAt": "2026-04-15T12:00:00Z",
    "lastReportedOverageSeverityStatus": 1,
    "usageTiers": [
      {
        "startUsage": 1,
        "startPercentage": 1,
        "endUsage": 1,
        "endPercentage": 1,
        "baseCredits": 1,
        "creditsPerUnitOfConsumption": 1,
        "name": "example",
        "quotaUsageLevel": 1,
        "quotaUsagePolicy": 1
      }
    ],
    "consumptionPeriod": "example",
    "accumulationMethod": 1
  },
  "balanceUsageId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "balanceUsage": {
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "name": "example",
    "description": "example",
    "creditsUsed": 1,
    "totalCredits": 1,
    "cumulativeCreditsUsed": 1,
    "unit": "example",
    "numberFormat": "example",
    "lastDeposit": "2026-04-15T12:00:00Z",
    "usageQuota": [
      {
        "endUsage": 1,
        "name": "example",
        "quotaUsageLevel": 1
      }
    ],
    "suspendedUntilAt": "2026-04-15T12:00:00Z",
    "overageSeverityStatus": 1,
    "initialCreditAmount": 1,
    "isUnlimitedCredits": true,
    "autoBalanceCronSchedule": "example",
    "lastAutoBalanceDate": "2026-04-15T12:00:00Z",
    "shouldAutoBalanceTransferCurrentCredits": true,
    "maxAutoBalanceCreditTransferAmount": 1,
    "autoBalanceCreditAmount": 1
  },
  "allowedBackDatingTolerance": "example"
}

object

id

string format: uuid

entitlementId

null | string format: uuid

productId

null | string format: uuid

metricName

string

name

string

description

string

unit

string

category

string

tags

Array<string>

numberFormat

string

metricType

integer

meteredUsageId

null | string format: uuid

meteredUsage

One of:

null

null

object

object

id

string format: uuid

suspendedUntilAt

null | string format: date-time

lastReportedOverageSeverityStatus

integer

usageTiers

Array<object>

Represents a tier of usage with associated credits and severity status.

object

startUsage

Gets or sets the start usage for the tier.

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

startPercentage

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

endUsage

Gets or sets the end usage for the tier. Nullable.

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

endPercentage

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

baseCredits

Gets or sets the flat fee credits for the tier.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

creditsPerUnitOfConsumption

Gets or sets the credits per unit of consumption for the tier.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

name

Gets or sets the name of the usage tier.

string

quotaUsageLevel

Gets or sets the overage severity status for the tier.

integer

quotaUsagePolicy

Defines the enforcement behavior applied by the resource controller or interceptor when a specific usage tier threshold is reached. Ordered from least to most restrictive.

integer

consumptionPeriod

string

accumulationMethod

integer

balanceUsageId

null | string format: uuid

balanceUsage

One of:

null

null

object

object

id

string format: uuid

name

string

description

string

creditsUsed

Consumed credits since last deposit. Remaining credits are calculated as TotalCredits - CreditsUsed.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

totalCredits

Total available credits.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

cumulativeCreditsUsed

The total of all credits used over time.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

unit

string

numberFormat

string

lastDeposit

string format: date-time

usageQuota

Array<object>

object

endUsage

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

name

string

quotaUsageLevel

integer

suspendedUntilAt

null | string format: date-time

overageSeverityStatus

integer

initialCreditAmount

The credits available when the entitlement is created.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

isUnlimitedCredits

Indicates if the resource has unlimited credits.

boolean

autoBalanceCronSchedule

Cron schedule for automatic credit balance. The cron syntax consists of five fields separated by spaces:

• Minute (0-59)
• Hour (0-23)
• Day of the Month (1-31)
• Month (1-12 or Jan-Dec)
• Day of the Week (0-6 or Sun-Sat) Special characters:
• • (asterisk): Represents any value for the field.
• , (comma): Separates multiple values.
• • (hyphen): Specifies a range of values.
• / (slash): Specifies increments. Example: “0 0 * * *” means “at midnight every day.”

null | string

lastAutoBalanceDate

Date and time of the last automatic credit balance.

string format: date-time

shouldAutoBalanceTransferCurrentCredits

Indicates if the current credits should be transferred.

boolean

maxAutoBalanceCreditTransferAmount

Maximum amount of credits that can be transferred automatically.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

autoBalanceCreditAmount

Amount of credits to balance automatically.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

allowedBackDatingTolerance

string

/^-?(\d+\.)?\d{2}:\d{2}:\d{2}(\.\d{1,7})?$/

Example ^generated

{
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "entitlementId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "productId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "metricName": "example",
  "name": "example",
  "description": "example",
  "unit": "example",
  "category": "example",
  "tags": [
    "example"
  ],
  "numberFormat": "example",
  "metricType": 1,
  "meteredUsageId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "meteredUsage": {
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "suspendedUntilAt": "2026-04-15T12:00:00Z",
    "lastReportedOverageSeverityStatus": 1,
    "usageTiers": [
      {
        "startUsage": 1,
        "startPercentage": 1,
        "endUsage": 1,
        "endPercentage": 1,
        "baseCredits": 1,
        "creditsPerUnitOfConsumption": 1,
        "name": "example",
        "quotaUsageLevel": 1,
        "quotaUsagePolicy": 1
      }
    ],
    "consumptionPeriod": "example",
    "accumulationMethod": 1
  },
  "balanceUsageId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "balanceUsage": {
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "name": "example",
    "description": "example",
    "creditsUsed": 1,
    "totalCredits": 1,
    "cumulativeCreditsUsed": 1,
    "unit": "example",
    "numberFormat": "example",
    "lastDeposit": "2026-04-15T12:00:00Z",
    "usageQuota": [
      {
        "endUsage": 1,
        "name": "example",
        "quotaUsageLevel": 1
      }
    ],
    "suspendedUntilAt": "2026-04-15T12:00:00Z",
    "overageSeverityStatus": 1,
    "initialCreditAmount": 1,
    "isUnlimitedCredits": true,
    "autoBalanceCronSchedule": "example",
    "lastAutoBalanceDate": "2026-04-15T12:00:00Z",
    "shouldAutoBalanceTransferCurrentCredits": true,
    "maxAutoBalanceCreditTransferAmount": 1,
    "autoBalanceCreditAmount": 1
  },
  "allowedBackDatingTolerance": "example"
}

object

id

string format: uuid

entitlementId

null | string format: uuid

productId

null | string format: uuid

metricName

string

name

string

description

string

unit

string

category

string

tags

Array<string>

numberFormat

string

metricType

integer

meteredUsageId

null | string format: uuid

meteredUsage

One of:

null

null

object

object

id

string format: uuid

suspendedUntilAt

null | string format: date-time

lastReportedOverageSeverityStatus

integer

usageTiers

Array<object>

Represents a tier of usage with associated credits and severity status.

object

startUsage

Gets or sets the start usage for the tier.

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

startPercentage

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

endUsage

Gets or sets the end usage for the tier. Nullable.

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

endPercentage

null | number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

baseCredits

Gets or sets the flat fee credits for the tier.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

creditsPerUnitOfConsumption

Gets or sets the credits per unit of consumption for the tier.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?$/

name

Gets or sets the name of the usage tier.

string

quotaUsageLevel

Gets or sets the overage severity status for the tier.

integer

quotaUsagePolicy

Defines the enforcement behavior applied by the resource controller or interceptor when a specific usage tier threshold is reached. Ordered from least to most restrictive.

integer

consumptionPeriod

string

accumulationMethod

integer

balanceUsageId

null | string format: uuid

balanceUsage

One of:

null

null

object

object

id

string format: uuid

name

string

description

string

creditsUsed

Consumed credits since last deposit. Remaining credits are calculated as TotalCredits - CreditsUsed.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

totalCredits

Total available credits.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

cumulativeCreditsUsed

The total of all credits used over time.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

unit

string

numberFormat

string

lastDeposit

string format: date-time

usageQuota

Array<object>

object

endUsage

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

name

string

quotaUsageLevel

integer

suspendedUntilAt

null | string format: date-time

overageSeverityStatus

integer

initialCreditAmount

The credits available when the entitlement is created.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

isUnlimitedCredits

Indicates if the resource has unlimited credits.

boolean

autoBalanceCronSchedule

Cron schedule for automatic credit balance. The cron syntax consists of five fields separated by spaces:

• Minute (0-59)
• Hour (0-23)
• Day of the Month (1-31)
• Month (1-12 or Jan-Dec)
• Day of the Week (0-6 or Sun-Sat) Special characters:
• • (asterisk): Represents any value for the field.
• , (comma): Separates multiple values.
• • (hyphen): Specifies a range of values.
• / (slash): Specifies increments. Example: “0 0 * * *” means “at midnight every day.”

null | string

lastAutoBalanceDate

Date and time of the last automatic credit balance.

string format: date-time

shouldAutoBalanceTransferCurrentCredits

Indicates if the current credits should be transferred.

boolean

maxAutoBalanceCreditTransferAmount

Maximum amount of credits that can be transferred automatically.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

autoBalanceCreditAmount

Amount of credits to balance automatically.

number | string format: double

/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/

allowedBackDatingTolerance

string

/^-?(\d+\.)?\d{2}:\d{2}:\d{2}(\.\d{1,7})?$/

Example ^generated

{
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "entitlementId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "productId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "metricName": "example",
  "name": "example",
  "description": "example",
  "unit": "example",
  "category": "example",
  "tags": [
    "example"
  ],
  "numberFormat": "example",
  "metricType": 1,
  "meteredUsageId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "meteredUsage": {
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "suspendedUntilAt": "2026-04-15T12:00:00Z",
    "lastReportedOverageSeverityStatus": 1,
    "usageTiers": [
      {
        "startUsage": 1,
        "startPercentage": 1,
        "endUsage": 1,
        "endPercentage": 1,
        "baseCredits": 1,
        "creditsPerUnitOfConsumption": 1,
        "name": "example",
        "quotaUsageLevel": 1,
        "quotaUsagePolicy": 1
      }
    ],
    "consumptionPeriod": "example",
    "accumulationMethod": 1
  },
  "balanceUsageId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "balanceUsage": {
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "name": "example",
    "description": "example",
    "creditsUsed": 1,
    "totalCredits": 1,
    "cumulativeCreditsUsed": 1,
    "unit": "example",
    "numberFormat": "example",
    "lastDeposit": "2026-04-15T12:00:00Z",
    "usageQuota": [
      {
        "endUsage": 1,
        "name": "example",
        "quotaUsageLevel": 1
      }
    ],
    "suspendedUntilAt": "2026-04-15T12:00:00Z",
    "overageSeverityStatus": 1,
    "initialCreditAmount": 1,
    "isUnlimitedCredits": true,
    "autoBalanceCronSchedule": "example",
    "lastAutoBalanceDate": "2026-04-15T12:00:00Z",
    "shouldAutoBalanceTransferCurrentCredits": true,
    "maxAutoBalanceCreditTransferAmount": 1,
    "autoBalanceCreditAmount": 1
  },
  "allowedBackDatingTolerance": "example"
}

Responses

200

OK

400

Bad Request

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

404

Not Found

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

object

type

null | string

title

null | string

status

null | integer | string format: int32

/^-?(?:0|[1-9]\d*)$/

detail

null | string

instance

null | string

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}