Skip to main content

Billing and resources

Console client configuration · Response and shared models

Billing endpoints operate on the signed-in tenant. Wallet values include available, reserved, consumed, and overdraft points, represented as strings. Separate lists expose ledger entries, usage events, and reservations. Usage can be filtered by application, environment, and time.

estimate returns estimated points and rating lines for participant counts, duration, resolution, recording, AI, conversion, storage, and CDN inputs. Plan and resource-package purchases require a business-generated idempotencyKey; reuse it when retrying the same purchase. Plan purchases activate or replace the subscription and grant points; the current server does not validate payment. Package purchases grant resources to the wallet. Auto recharge defines a package, threshold, monthly limit, and enabled state.

billing.wallet​

Wallet balance.

GET /v1/billing/wallet

Authentication: tenant Bearer token.

LanguageCall
Node.jsc.billing.wallet()
Pythonc.billing.wallet()
Javac.billing.wallet()
Goc.Billing.Wallet(ctx, &result)
PHP$c->billing->wallet()

No request fields.

Returns: WalletSummary. See shared models for nested fields.

billing.entitlements​

Tenant entitlements.

GET /v1/billing/entitlements

Authentication: tenant Bearer token.

LanguageCall
Node.jsc.billing.entitlements()
Pythonc.billing.entitlements()
Javac.billing.entitlements()
Goc.Billing.Entitlements(ctx, &result)
PHP$c->billing->entitlements()

No request fields.

Returns: EntitlementSnapshot. See shared models for nested fields.

billing.listPlans​

Plan catalog.

GET /v1/billing/plans

Authentication: tenant Bearer token.

LanguageCall
Node.jsc.billing.listPlans()
Pythonc.billing.list_plans()
Javac.billing.listPlans()
Goc.Billing.ListPlans(ctx, &result)
PHP$c->billing->listPlans()

No request fields.

Returns: CatalogList<PlanCatalogItem>. See shared models for nested fields.

billing.listPackages​

Resource package catalog.

GET /v1/billing/packages

Authentication: tenant Bearer token.

LanguageCall
Node.jsc.billing.listPackages()
Pythonc.billing.list_packages()
Javac.billing.listPackages()
Goc.Billing.ListPackages(ctx, &result)
PHP$c->billing->listPackages()

No request fields.

Returns: CatalogList<ResourcePackageItem>. See shared models for nested fields.

billing.estimate​

Estimate classroom usage.

POST /v1/billing/estimate

Authentication: tenant Bearer token.

LanguageCall
Node.jsc.billing.estimate(input)
Pythonc.billing.estimate(**input)
Javac.billing.estimate(input)
Goc.Billing.Estimate(ctx, input, &result)
PHP$c->billing->estimate($input)

Input: ClassroomEstimatePayload. Fields are sent in the JSON body.

FieldRequiredTypeDescription
onStageCountYesnumberEstimated on-stage participants
audienceCountNonumber | undefinedEstimated audience participants
durationMinutesYesnumberDuration in minutes; classroom creation accepts 5–480
resolutionTierNostring | undefinedResolution tier for pricing
recordModeNostring | undefinedRecording mode
aiSubtitleNoboolean | undefinedInclude AI subtitles
aiSummaryNoboolean | undefinedInclude AI summary
transcodeMinutesNonumber | undefinedTranscoding minutes
storageGbMonthNonumber | undefinedStorage in GB-months
cdnGbNonumber | undefinedCDN delivery in GB

Returns: ClassroomEstimateResult. See shared models for nested fields.

billing.listLedger​

Points ledger.

GET /v1/billing/ledger

Authentication: tenant Bearer token.

LanguageCall
Node.jsc.billing.listLedger(input)
Pythonc.billing.list_ledger(**input)
Javac.billing.listLedger(input)
Goc.Billing.ListLedger(ctx, input, &result)
PHP$c->billing->listLedger($input)

Input: LedgerInput. Fields are sent as URL query parameters.

FieldRequiredTypeDescription
typeNostring | undefinedLedger entry type
statusNostring | undefinedStatus filter or target status
pageNonumber | undefinedPage number starting at 1
pageSizeNonumber | undefinedMaximum items per page

Returns: Paged<LedgerEntry>. See shared models for nested fields.

billing.listUsage​

Usage records.

GET /v1/billing/usage

Authentication: tenant Bearer token.

LanguageCall
Node.jsc.billing.listUsage(input)
Pythonc.billing.list_usage(**input)
Javac.billing.listUsage(input)
Goc.Billing.ListUsage(ctx, input, &result)
PHP$c->billing->listUsage($input)

Input: UsageInput. Fields are sent as URL query parameters.

FieldRequiredTypeDescription
scopeNo"dashboard" | undefinedUsage scope; dashboard uses dashboard aggregation
appIdNostring | undefinedTarget application ID
environmentNoAppEnvironment | undefinedApplication environment
fromNostring | undefinedRange start, ISO 8601
toNostring | undefinedRange end, ISO 8601
typeNostring | undefinedLedger entry type
statusNostring | undefinedStatus filter or target status
pageNonumber | undefinedPage number starting at 1
pageSizeNonumber | undefinedMaximum items per page

Returns: Paged<UsageRecord>. See shared models for nested fields.

billing.listReservations​

Resource reservations.

GET /v1/billing/reservations

Authentication: tenant Bearer token.

LanguageCall
Node.jsc.billing.listReservations(input)
Pythonc.billing.list_reservations(**input)
Javac.billing.listReservations(input)
Goc.Billing.ListReservations(ctx, input, &result)
PHP$c->billing->listReservations($input)

Input: ReservationsInput. Fields are sent as URL query parameters.

FieldRequiredTypeDescription
statusNostring | undefinedStatus filter or target status
pageNonumber | undefinedPage number starting at 1
pageSizeNonumber | undefinedMaximum items per page

Returns: Paged<ReservationRecord>. See shared models for nested fields.

billing.purchasePlan​

Purchase plan.

POST /v1/billing/plans/purchase

Authentication: tenant Bearer token.

LanguageCall
Node.jsc.billing.purchasePlan(input)
Pythonc.billing.purchase_plan(**input)
Javac.billing.purchasePlan(input)
Goc.Billing.PurchasePlan(ctx, input, &result)
PHP$c->billing->purchasePlan($input)

Input: PurchasePlanPayload. Fields are sent in the JSON body.

FieldRequiredTypeDescription
planKeyYesstringPlan key
periodNostring | undefinedPurchase period; defaults to monthly
idempotencyKeyYesstringBusiness idempotency key; reuse for retries of one purchase

Returns: PurchasePlanResult. See shared models for nested fields.

billing.purchasePackage​

Purchase resource package.

POST /v1/billing/packages/purchase

Authentication: tenant Bearer token.

LanguageCall
Node.jsc.billing.purchasePackage(input)
Pythonc.billing.purchase_package(**input)
Javac.billing.purchasePackage(input)
Goc.Billing.PurchasePackage(ctx, input, &result)
PHP$c->billing->purchasePackage($input)

Input: PurchasePackagePayload. Fields are sent in the JSON body.

FieldRequiredTypeDescription
packageKeyYesstringResource package key
idempotencyKeyYesstringBusiness idempotency key; reuse for retries of one purchase

Returns: WalletSummary. See shared models for nested fields.

billing.getAutoRecharge​

Get auto recharge.

GET /v1/billing/auto-recharge

Authentication: tenant Bearer token.

LanguageCall
Node.jsc.billing.getAutoRecharge()
Pythonc.billing.get_auto_recharge()
Javac.billing.getAutoRecharge()
Goc.Billing.GetAutoRecharge(ctx, &result)
PHP$c->billing->getAutoRecharge()

No request fields.

Returns: AutoRechargeRule. See shared models for nested fields.

billing.setAutoRecharge​

Set auto recharge.

POST /v1/billing/auto-recharge

Authentication: tenant Bearer token.

LanguageCall
Node.jsc.billing.setAutoRecharge(input)
Pythonc.billing.set_auto_recharge(**input)
Javac.billing.setAutoRecharge(input)
Goc.Billing.SetAutoRecharge(ctx, input, &result)
PHP$c->billing->setAutoRecharge($input)

Input: UpsertAutoRechargePayload. Fields are sent in the JSON body.

FieldRequiredTypeDescription
packageKeyYesstringResource package key
thresholdPointsYesstringAuto recharge points threshold as a string
monthlyLimitYesnumberMaximum auto recharges per month
enabledYesbooleanWhether auto recharge is enabled

Returns: AutoRechargeRule. See shared models for nested fields.