Sign in

v2

latestOpenAPI 3.1.02026-08-05267431678.1 KB
billing

Get Seat Change Preview

Preview cost impact of adding or removing seats without applying changes.

Requires MANAGE_BILLING permission.

Args: team_id: Team UUID. action: Either 'add' or 'remove'. count: Number of seats to change. auth: Authenticated user context.

Returns: SeatChangePreview with current/new seat counts and pricing.

get/billing/team/{team_id}/seat-preview

Path parameters

team_idstring required

Query parameters

actionstring required

'add' or 'remove'

'add' or 'remove'

countinteger

Number of seats to add/remove

Number of seats to add/remove

Response

Successful Response

current_seatsinteger required

Current number of seats

new_seatsinteger required

Seat count after the change

unit_priceinteger required

Price per seat in whole dollars

intervalstring required

Billing interval: 'month' or 'year'

new_totalinteger required

New total cost per interval in whole dollars

proration_amountinteger nullable

Estimated proration charge in whole dollars, if available