---
title: "Update billing entity settings"
method: PUT
path: "/company-billing-entity-settings/{company_id}"
tags: ["companies"]
---

# Update billing entity settings

`PUT /company-billing-entity-settings/{company_id}`

## Request

- Base URL: `https://api.schematichq.com`
- URL: `https://api.schematichq.com/company-billing-entity-settings/{company_id}`
- Auth: API key in header `X-Schematic-Api-Key`

## Path parameters

- `company_id` string, required

## Request body

- UpdateBillingEntitySettingsRequestBody
  - `children_may_change_plan` boolean, nullable, required: Whether the companies this company pays for may change their own plan and add-ons in components. The change is billed to this company. When false, they may only cancel.

## Response `200`

OK

- object
  - `data` CompanyBillingEntitySettingsResponseData, required
    - `billing_date` string, date-time, nullable
    - `children_may_change_plan` boolean, required
    - `company_id` string, required
  - `params` object, required: Input parameters

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `500`: Server error

## Changes

> 524 revisions in range; 1 not diffed.

- **2026-11-04** `aed1b24cb8d3`: 1 info
  - added the optional property `data/billing_date` to the response with the `200` status
- **2026-11-04** `3a3c0af9a904`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/schematichq/apis/schematic-api/changes/company-billing-entity-settings/:company_id/put.md)

---

[API](https://skmtc.dev/schematichq/apis/schematic-api.md) - [All operations](https://skmtc.dev/schematichq/apis/schematic-api/llms.txt) - [OpenAPI document](https://skmtc.dev/schematichq/apis/schematic-api/revisions/c56b86491fbf?raw)
