Update a usage record

put

https://v3.recurly.com/usage/{usage_id}

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

usage_id

string

required

Usage Record ID.

Body Params

merchant_tag

string

Custom field for recording the id in your own system associated with the usage, so you can provide auditable usage displays to your customers using a GET on this endpoint.

amount

float

The amount of usage. Can be positive, negative, or 0. If the Decimal Quantity feature is enabled, this value will be rounded to nine decimal places. Otherwise, all digits after the decimal will be stripped. If the usage-based add-on is billed with a percentage, your usage should be a monetary amount formatted in cents (e.g., $5.00 is "500").

recording_timestamp

date-time

When the usage was recorded in your system.

usage_timestamp

date-time

When the usage actually happened. This will define the line item dates this usage is billed under and is important for revenue recognition.

Responses

200The updated usage record.

400Invalid or unpermitted parameter.

404Incorrect site or subscription, add-on, or usage ID.

422A validation error.

defaultUnexpected error.