admin

Update Org

Changed on

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}

Request

  • Base URL
    https://api.quadrillion.io (the document declares no server; this is the origin it was published from)
  • URL
    https://api.quadrillion.io/api/admin/organizations/{org_id}
  • Auth
    none declared

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
billing_mode'free_pilot'

Why an organization is in the billing state it is in.

Recorded on organizations.settings["billing_mode"]. Absence means "ordinary paid org" — the overwhelming majority — so only deliberate exceptions carry a value.

FREE_PILOT records intent. The gating itself comes from the absence of payment_method_status: every reader compares it to "pending" exactly, so an absent key passes both usage gates while leaving the setup-link path open (regenerate_enterprise_setup_session refuses only on "active"). Absence alone cannot distinguish a deliberate free pilot from an org whose payment state was never stamped, which is what this key is for.

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
billing_modestring nullable
next_stepsstring nullable
stripe_customer_urlstring nullable
stripe_subscription_urlstring nullable
workos_organization_idstring nullable

Changes

  • abf76937a751Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • f2518d494326Revision changes
    • info

      added the new optional request property

    • info

      added the optional property to the response with the status