Admin APIs
distributors
Wholesale Distribution

Add Contract Tier

Add a tier to an existing contract (PRO-2569). Slots may be 0 — a 0-slot tier is a valid upgrade/downgrade target that fills only via transfers.

post/api/v1/admin/distributors/contracts/{contract_id}/tiers

Request

  • Base URL: https://carbonarc.ai (the document declares no server; this is the origin it was published from)
  • URL: https://carbonarc.ai/api/v1/admin/distributors/contracts/{contract_id}/tiers
  • Auth: OAuth 2 (authorization code, authorization URL authorize, token URL token)

Path parameters

contract_idstring uuid required

Request body

mcp_mapping_idstring uuid4 required
slots_purchasedinteger required
wholesale_price_centsinteger required

Response

Successful Response

idstring uuid4 required
namestring nullable
slots_purchasedinteger required
slots_occupiedinteger required
slots_availableinteger required
wholesale_price_centsinteger nullable
mcp_mapping_idstring uuid4 nullable
mcp_daily_token_capinteger nullable
statusstring required

Changes

No recorded changes to this operation across all 4 revisions of this API.