---
title: "Update Org Billing"
method: PATCH
path: "/api/v1/internal/organizations/{org_id}/billing"
tags: ["internal_admin"]
---

# Update Org Billing

`PATCH /api/v1/internal/organizations/{org_id}/billing`

## Request

- Base URL: `https://api.komos.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.komos.ai/api/v1/internal/organizations/{org_id}/billing`
- Auth: none declared

Update billing configuration for an org (enterprise setup).

## Path parameters

- `org_id` string, required

## Headers

- `Authorization` string, nullable
- `X-Org-Id` string, nullable

## Request body

- UpdateBillingRequest
  - `plan_key` string, nullable
  - `billing_cycle` string, nullable
  - `current_period_start` string, date-time, nullable
  - `current_period_end` string, date-time, nullable
  - `contract_start` string, date-time, nullable
  - `contract_end` string, date-time, nullable
  - `status` string, nullable
  - `billing_company_name` string, nullable
  - `billing_contact_name` string, nullable
  - `billing_email` string, nullable
  - `billing_address` string, nullable
  - `payment_terms` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/komos/apis/komos-backend.md) · [All operations](https://skmtc.dev/komos/apis/komos-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/komos/apis/komos-backend/revisions/f10e153fab38?raw)