---
title: "CRUD: Update a usage record"
method: PUT
path: "/v1/object/usage/{id}"
tags: ["Usage"]
---

# CRUD: Update a usage record

`PUT /v1/object/usage/{id}`

Updates a usage record. Updating usage records that are associated with a dynamic pricing usage charge is not supported through this endpoint. The request fails and the record is not updated. Use Mediation-based flows to manage such usage.

## Path parameters

- `id` string, required

## Query parameters

- `rejectUnknownFields` boolean

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Track-Id` string
- `Zuora-Version` string

## Request body

- ProxyModifyUsage — Container for custom fields of a Usage object.
  - `EndDateTime` string, date-time — The end date and time of a range of time when usage is tracked. Use this field for reporting; this field doesn't affect usage calculation. **Character limit**: 29 **Values**: a valid date and time value
  - `Quantity` number, double — Indicates the number of units used. **Character limit**: 16 **Values**: A valid decimal amount.
  - `RbeStatus` string — Indicates if the rating and billing engine (RBE) processed usage data for an invoice. **Character limit**: 9 **Values**: automatically generated to be one of the following values: `Importing`, `Pending`, `Processed`
  - `StartDateTime` string, date-time — The start date and time of a range of time when usage is tracked. Zuora uses this field value to determine the usage date. Unlike the `EndDateTime`, the `StartDateTime` field does affect usage calculation. **Character limit**: 29 **Values**: a valid date and time value
  - `UOM` string — Specifies the units to measure usage. Units of measure are configured in the web-based UI. Your values depend on your configuration in **Billing Settings**. **Character limit**: **Values**: a valid unit of measure

## Response `200`

OK

- ProxyCreateOrModifyResponse
  - `Id` string
  - `Success` boolean

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)