billing

Change the account's plan.

Moves the account to a self-serve plan; a plan with a fee is billed through the card on file. Requires the billing:write scope.

post/v1/account/plan

Request

Base URL
https://api.smolmachines.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/smolmachines/apis/smolfleet-api/docs/v1/account/plan/post.ts
A function with typed inputs. Its response is checked against the schema.

planIdstring required

Plan id to move onto, e.g. plan-startup-paid.

The plan now in effect: a move onto a fee plan applies at once, a move off one when the paid period ends.

allowAlwaysOnboolean required

budgetPolicystring required

createdAtstring required

freeCreditMicrosinteger

Recurring free credit applied to each billing period, in micros (e.g. 5_000_000 = $5/month free). Discount applies after volume tiers.

idstring required

isDefaultboolean required

maxConcurrentMachinesinteger required

maxCpusinteger required

maxDiskGbinteger nullable

Largest disk (GB) one machine may request; null = platform maximum.

maxEgressGbinteger nullable

maxGroupsinteger required

maxMachinesinteger required

maxMemoryMbinteger required

monthlyBudgetMicrosinteger nullable

monthlyFeeMicrosinteger required

Flat recurring platform fee (micros per period); 0 = usage-only plan.

namestring required

rateBaseHourMicrosinteger

Per-machine-alive-hour "slot" fee in micros (e.g. 40_000 = $0.04/hr). Prices the held VM slot on top of consumed CPU/RAM — not allocated resources.

rateCpuHourMicrosinteger required

rateDiskGbHourMicrosinteger

rateEgressGbMicrosinteger

rateExecMicrosinteger required

rateMemoryGbHourMicrosinteger required

selfServeboolean

Whether a tenant may switch itself onto this plan. Operator-only tiers are false and never appear in the self-serve list.