---
title: "PUT /usage/records/{id}"
method: PUT
path: "/usage/records/{id}"
tags: ["Usage Reporting"]
---

# PUT /usage/records/{id}

`PUT /usage/records/{id}`

## Path parameters

- `id` string, required

## Request body

- object
  - `status` 'valid' | 'invalid' | 'approved' | 'rejected' | 'closed'

## Response `200`

- UsageUsageRecord
  - `id` string
  - `start_date` string, date-time
  - `end_date` string, date-time
  - `product_id` string, nullable
  - `external_billing_id` string
  - `external_billing_note` string
  - `item` UsageReferenceItem — Serialize reference item object
    - `id` string, required
    - `local_id` string, nullable
    - `name` string, required
    - `unit` string, nullable
    - `mpn` string, nullable
    - `precision` string
    - `type` string
  - `asset` UsageReferenceAsset — Serialize reference asset object
    - `id` string, required
    - `external_id` string, nullable
    - `external_uid` string, nullable
  - `category` string
  - `tier` integer, nullable
  - `amount` number, nullable
  - `multiplier` integer
  - `usage` number, required
  - `status` 'valid' | 'invalid' | 'approved' | 'rejected' | 'closed', nullable
  - `closed_at` string, date-time, nullable
  - `closed_by` string, nullable
  - `params` UsageUsageRecordParameters[]
    - `parameter_name` string, required
    - `parameter_value` string, nullable
  - `item_id` string
  - `asset_id` string
  - `usagefile` UsageReferenceUsageFile, required
    - `id` string
    - `name` string, nullable
    - `schema` 'tr' | 'pr' | 'qt' | 'cr'
    - `currency` string, nullable
  - `resource_local_id` string
  - `asset_external_id` string
  - `asset_external_uid` string

## Other responses

- `400`

---

[API](https://skmtc.net/cloudblue/apis/cloudblue-connect-api.md) · [All operations](https://skmtc.net/cloudblue/apis/cloudblue-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudblue/cloudblue-connect-api/revisions/0421d2a97c52/schema)