Skip to main content
POST
Add seats
Requires credit_from_referral_partner: false at registration. Holding cost: 150 × seats × months on first grant (default 150 credits per seat per month). Adding seats mid-period is prorated. Fails if the business already has its own active Plus subscription.

Authorizations

X-API-Key
string
header
default:your_tyms_sk_or_partner_key
required

Business secret tyms_sk_... for business-scoped routes. Partner secret for register-business and referred-business distributor routes.

Path Parameters

business_uuid
string
required

Body

application/json
seats
integer
required

Plus seats to grant, or add when a partner grant is already active.

Required range: 1 <= x <= 500
months
integer
default:1

Length of the Plus period. Used on the first grant only; ignored when adding seats mid-period (remaining time is prorated).

Required range: 1 <= x <= 24

Response

Seats granted

status
string
Example:

"success"

message
string
data
object