Commits consumption on a metered asset. Use idempotentKey to make retries safe.

POST

/api/v1/provision/usage/try-consume/{sessionId}/{metric}

curl --request POST \
  --url https://example.com/api/v1/provision/usage/try-consume/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/example

Parameters

Path Parameters

sessionId

required

string format: uuid

Active license session.

metric

required

string

Metric name.

Query Parameters

amount

number | string format: double

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

Quantity to commit.

idempotentKey

string

Optional idempotency key for safe retries.

Responses

200

OK

object

tier

required

string

currentValue

required

null | number | string format: double

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

start

required

null | number | string format: double

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

limit

required

null | number | string format: double

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

usagePercentage

required

null | number | string format: double

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

quotaUsageLevel

required

integer

quotaUsagePolicy

required

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

periodResetAt

null | string format: date-time

object

tier

required

string

currentValue

required

null | number | string format: double

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

start

required

null | number | string format: double

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

limit

required

null | number | string format: double

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

usagePercentage

required

null | number | string format: double

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

quotaUsageLevel

required

integer

quotaUsagePolicy

required

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

periodResetAt

null | string format: date-time

Example ^generated

{
  "tier": "example",
  "currentValue": 1,
  "start": 1,
  "limit": 1,
  "usagePercentage": 1,
  "quotaUsageLevel": 1,
  "quotaUsagePolicy": 1,
  "periodResetAt": "2026-04-15T12:00:00Z"
}

object

tier

required

string

currentValue

required

null | number | string format: double

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

start

required

null | number | string format: double

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

limit

required

null | number | string format: double

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

usagePercentage

required

null | number | string format: double

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

quotaUsageLevel

required

integer

quotaUsagePolicy

required

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

periodResetAt

null | string format: date-time

Example ^generated

{
  "tier": "example",
  "currentValue": 1,
  "start": 1,
  "limit": 1,
  "usagePercentage": 1,
  "quotaUsageLevel": 1,
  "quotaUsagePolicy": 1,
  "periodResetAt": "2026-04-15T12:00:00Z"
}

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"
}