BizKitHub
DocsAPI ReferenceAdmin/bff/admin/organisation-tariff-change
postAdminAdmin BFF

/bff/admin/organisation-tariff-change

Runs changeTariff: validates, writes the tariff + assignment in one transaction and, when something changed, records a critical ORG_TARIFF_CHG system log entry (before/after + actor) with a forced notification e-mail and activity rows naming the admin. Requires internal admin membership.

AdminpostBffAdminOrganisation-tariff-change

Parameters

JSON body

Request body

application/json
slugstringRequired

Slug of the target organisation.

Exampleacme-corp
tariffIdnumberRequired

Tariff to assign (may equal the current one to edit settings only).

Example3
customPriceCzkstring | integer | nullOptional
One of 2:
Variant 1
string | integer

Negotiated monthly price in whole CZK. Null = use catalogue price minus discount. Omit to keep.

One of 2:
Variant 1
stringinteger
Default: 0
Variant 2
integer

Negotiated monthly price in whole CZK. Null = use catalogue price minus discount. Omit to keep.

Range: 0–∞
Variant 2
null
discountPercentstring | integerOptional

Discount off the catalogue price. Omit to keep.

One of 2:
Variant 1
stringinteger
Default: 0
Variant 2
integer

Discount off the catalogue price. Omit to keep.

Range: 0–100
paidUntilstring | nullOptional
One of 2:
Variant 1
string

Paid-until / next renewal date (ISO). Null clears it. Omit to keep.

Variant 2
null
notestring | nullOptional
One of 2:
Variant 1
string

Admin note. Null clears it.

Length: 0–2000
Variant 2
null
salespersonUserIdstring | integer | nullOptional
One of 2:
Variant 1
string | integer

cas__user id of the salesperson. Null = self-service.

One of 2:
Variant 1
stringinteger
Default: 0
Variant 2
integer

cas__user id of the salesperson. Null = self-service.

Variant 2
null
salespersonCommissionCzkstring | integer | nullOptional
One of 2:
Variant 1
string | integer

Locked commission for the salesperson in whole CZK.

One of 2:
Variant 1
stringinteger
Default: 0
Variant 2
integer

Locked commission for the salesperson in whole CZK.

Range: 0–∞
Variant 2
null

Response schema

1 status code documented

200Success
changedbooleanRequired

False when the submitted values equal the current state (nothing written).

tariffSwitchedbooleanRequired

True when the plan itself changed.

needsCustomPricebooleanRequired

Plan requires a custom price (Enterprise) and none is set.

Response example

application/json
{
  "changed": false,
  "tariffSwitched": false,
  "needsCustomPrice": false
}

Request example

POST /bff/admin/organisation-tariff-change

post
curl -X POST "https://api.bizkithub.com/bff/admin/organisation-tariff-change" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "slug": "acme-corp",
  "tariffId": 3
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key