Skip to main content

Seats

Team seats are billing-account capacity. They are not usage-gate policies.

Model​

ObjectSeat meaning
Billing accountOwns the effective seat_limit for the team.
Billing userConsumes one seat when status = active.
Disabled/deleted billing userDoes not consume a seat.

billing_accounts.seat_limit = null means unlimited seats. 0 means no active billing users are allowed. A positive value limits the number of active billing users under that billing account.

Management APIs​

  • GET /mgt/v1/billing-accounts?expand=seat_summary
  • GET /mgt/v1/billing-accounts/{billing_account_id}/seat-summary
  • PATCH /mgt/v1/billing-accounts/{billing_account_id}

Create, restore, and inactive-to-active billing user mutations enforce the account seat limit. Reducing a seat limit below the current active user count does not disable existing users; it puts the account over limit and blocks new active-user growth until capacity is available.