--- title: "Changes to Record a usage event" method: POST path: "/v1/sdk/usages" --- # Changes to Record a usage event `POST /v1/sdk/usages` > Every recorded change to this endpoint, newest first. ## Timeline Changed in 11 of 27 revisions. - **2026-07-30** `8578b7536a9f` — 1 info - **2026-07-17** `bbc2ff2bc849` — 3 warning - **2026-07-04** `a30b6aef464d` — 5 info - **2026-04-08** `052cc028fdfa` — 1 breaking, 1 warning - **2026-04-07** `d69c95d790d2` — 2 warning, 2 info - **2026-04-04** `88abf6f50f11` — 4 breaking, 5 warning, 6 info - **2026-03-25** `e0583a41987c` — 1 breaking, 7 warning, 8 info - **2026-03-16** `9fd92a720973` — 2 breaking, 8 warning, 6 info - **2026-03-16** `c38fce7d1ce2` — 2 breaking, 4 warning, 7 info - **2026-03-14** `0e1cded2ee5d` — 1 breaking, 7 warning, 3 info - **2026-02-27** `9079f361f51c` — 1 info ## Changes - **2026-07-30** `8578b7536a9f` — 1 info - the request property `metadata` became optional - **2026-07-17** `bbc2ff2bc849` — 3 warning - the `customerRef` request property's maxLength was set to `20` - the `productRef` request property's maxLength was set to `20` - the `purchaseRef` request property's maxLength was set to `20` - **2026-07-04** `a30b6aef464d` — 5 info - the endpoint scheme security `SecretKey` was added to the API - the endpoint scheme security `bearer` was removed from the API - added the optional property `creditDebit` to the response with the `200` status - the response property `reference` became required for the status `200` - the response property `success` became required for the status `200` - **2026-04-08** `052cc028fdfa` — 1 breaking, 1 warning - added the new required request property `customerRef` - removed the request property `customerId` - **2026-04-07** `d69c95d790d2` — 2 warning, 2 info - removed the request property `productReference` - removed the request property `purchaseReference` - added the new optional request property `productRef` - added the new optional request property `purchaseRef` - **2026-04-04** `88abf6f50f11` — 4 breaking, 5 warning, 6 info - the request property `metadata` became required - the request property `timestamp` became required - the `customerId` request property's minLength was increased from `0` to `1` - the `units` request property type changed from `number` to `integer` - the `units` request property's exclusiveMaximum was set to `false` - the `units` request property's exclusiveMinimum was set to `false` - the `idempotencyKey` request property's maxLength was set to `256` - the `units` request property's max was set to `100000.00` - the `units` request property's min was set to `0.00` - added the new optional request property `description` - added the new optional request property `duration` - added the new optional request property `errorMessage` - the `actionType` request property default value `api_call` was added - the `outcome` request property default value `success` was added - the `units` request property default value `1` was added - **2026-03-25** `e0583a41987c` — 1 breaking, 7 warning, 8 info - added the new required request property `customerId` - removed the request property `action` - removed the request property `customActionKey` - removed the request property `customerRef` - removed the request property `description` - removed the request property `productRef` - removed the request property `toolName` - removed the optional property `outcome` from the response with the `200` status - added the new optional request property `actionType` - added the new optional request property `idempotencyKey` - added the new optional request property `outcome` - added the new optional request property `productReference` - added the new optional request property `purchaseReference` - added the new optional request property `timestamp` - removed the non-success response with the status `404` - added the optional property `reference` to the response with the `200` status - **2026-03-16** `9fd92a720973` — 2 breaking, 8 warning, 6 info - added the new required request property `customerRef` - added the new required request property `productRef` - removed the request property `actionType` - removed the request property `customerId` - removed the request property `idempotencyKey` - removed the request property `outcome` - removed the request property `productReference` - removed the request property `purchaseReference` - removed the request property `timestamp` - removed the optional property `reference` from the response with the `200` status - added the new optional request property `action` - added the new optional request property `customActionKey` - added the new optional request property `description` - added the new optional request property `toolName` - added the non-success response with the status `404` - added the optional property `outcome` to the response with the `200` status - **2026-03-16** `c38fce7d1ce2` — 2 breaking, 4 warning, 7 info - added the new required request property `customerId` - the `timestamp` request property format changed from no format to `date-time` - removed the request property `customerRef` - removed the request property `meterName` - removed the request property `properties` - removed the optional property `units` from the response with the `200` status - added the new optional request property `actionType` - added the new optional request property `idempotencyKey` - added the new optional request property `metadata` - added the new optional request property `outcome` - added the new optional request property `productReference` - added the new optional request property `purchaseReference` - added the optional property `reference` to the response with the `200` status - **2026-03-14** `0e1cded2ee5d` — 1 breaking, 7 warning, 3 info - added the new required request property `meterName` - removed the request property `action` - removed the request property `customActionKey` - removed the request property `description` - removed the request property `metadata` - removed the request property `productRef` - removed the request property `toolName` - removed the optional property `outcome` from the response with the `200` status - added the new optional request property `properties` - added the new optional request property `timestamp` - removed the non-success response with the status `404` - **2026-02-27** `9079f361f51c` — 1 info - endpoint added --- [Operation](https://skmtc.dev/solvapay/apis/solvapay-rest-api/docs/v1/sdk/usages/post.md) · [API](https://skmtc.dev/solvapay/apis/solvapay-rest-api.md) · [Page](https://skmtc.dev/solvapay/apis/solvapay-rest-api/changes/v1/sdk/usages/post)