Sign in

v4

latestOpenAPI 3.1.02026-08-08349225311.7 KB
admin

Update Org

Edit an enterprise organization's billing profile (admin only).

Covers seat price, per-user usage cap, overage toggle/ceiling, API markup, org name, and billing email. Seat-price changes create a new per-org Stripe Price and swap the subscription item with proration. Name/email changes are mirrored to the Stripe Customer so invoices stay aligned. An append-only billing_events row captures {before, after, reason}.

patch/api/admin/organizations/{org_id}

Path parameters

org_idinteger required

Request body

namestring nullable
billing_emailstring nullable
seat_price_centsinteger nullable
usage_limit_per_user_usdnumber nullable
overage_enabledboolean nullable
overage_limit_per_user_usdinteger nullable
api_markup_ratenumber nullable
reasonstring nullable

Response

Successful Response

idinteger required
namestring required
slugstring required
stripe_customer_idstring nullable required
billing_emailstring nullable required
api_markup_ratenumber nullable required
archived_atstring nullable required
created_atstring required
updated_atstring required
member_countinteger nullable
payment_method_statusstring nullable
next_stepsstring nullable
stripe_customer_urlstring nullable
stripe_subscription_urlstring nullable
workos_organization_idstring nullable