---
title: "Update BillConfig"
method: PUT
path: "/organizations/{orgId}/billconfig"
tags: ["BillConfig"]
---

# Update BillConfig

`PUT /organizations/{orgId}/billconfig`

Update the Organization-wide BillConfig.

You can use this endpoint to set a global lock date for **all** Bills - any Bill with a service period end date on or before the set date will be locked and cannot be updated or recalculated.

## Path parameters

- `orgId` string, required

## Request body

- BillConfigRequest
  - `version` integer — The version number: * Default value when newly created is one. * On Update, version is required and must match the existing version because a check is performed to ensure sequential versioning is preserved. Version is incremented by 1 and listed in the response
  - `billLockDate` string, date — The global lock date when all Bills will be locked *(in ISO 8601 format)*. For example: `"2024-03-01"`.

## Response `200`

Return the updated BillConfig

- BillConfigResponse
  - `id` string, required — The UUID of the entity.
  - `version` integer — The version number: - **Create:** On initial Create to insert a new entity, the version is set at 1 in the response. - **Update:** On successful Update, the version is incremented by 1 in the response.
  - `billLockDate` string, date — The global lock date *(in ISO 8601 format)* when all Bills will be locked. For example: `"2024-03-01"`.
  - `dtCreated` string, date-time — The DateTime *(in ISO-8601 format)* when the bill config was first created.
  - `dtLastModified` string, date-time — The DateTime *(in ISO-8601 format)* when the bill config was last modified.
  - `createdBy` string — The id of the user who created this bill config.
  - `lastModifiedBy` string — The id of the user who last modified this bill config.

## Other responses

- `4XX` — Error message
- `5XX` — Error message

---

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