/bff/tariff/assign

Assigns a tariff to an organisation. Updates both the organisation_tariff record and the tariff_id on the organisation table. Switches reset paid-until — follow up with /tariff/set-billing to set the negotiated price + paidUntil. Allowed for internal admin OR the vendor of the target organisation.

TariffpostBffTariffAssign

Parameters

JSON body

Request body

application/json

organisationSlugstringRequired

Slug of the target organisation.

Examplemy-shop

tariffIdnumberRequired

ID of the tariff to assign.

Example3

notestringOptional

Admin note (e.g. VIP client, volume discount).

ExampleVIP client

Response schema

1 status code documented

200Success

successbooleanRequired

needsCustomPricebooleanRequired

TRUE when the new tariff requires a custom price (Enterprise) and none is currently set. The admin should follow up with /tariff/set-billing.

Response example

application/json

{
  "success": false,
  "needsCustomPrice": false
}

Request example

POST /bff/tariff/assign

post

curl -X POST "https://api.bizkithub.com/bff/tariff/assign" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "organisationSlug": "my-shop",
  "tariffId": 3,
  "note": "VIP client"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key