Seats API

Review reseller seat capacity and adjust company-level allocations.

MethodEndpointDescription
GET/v1/reseller/seats/summaryGet reseller seat pool usage.
GET/v1/reseller/companies/{id}/seatsGet company seat details.
PATCH/v1/reseller/companies/{id}/seatsUpdate company allocation.

Seat Summary

The summary endpoint reports total reseller capacity, allocated seats, used seats, and remaining seats.

{
  "data": {
    "total_seats": 500,
    "allocated_seats": 300,
    "used_seats": 245,
    "available_seats": 200
  }
}

Update Allocation

FieldTypeDescription
seat_limitintegerNew company seat limit.
seat_limit_typestringhard or soft.

Validation

Seat limits cannot be reduced below current usage, and allocations cannot exceed the reseller pool.