Account

Read account quota

Read the effective plan, account pool ceilings, per-computer maxima and current consumption before choosing a create or resize. Viewer or stronger; workspace-scoped keys receive whole-account aggregates without resource, workspace, member or billing identities. An authorized holder may read a suspended account to understand its quota. Suspended holders and revoked credentials remain refused.

READ complete BEFORE USING NUMBERS. An incomplete computer or snapshot collection returns 200 with every usage and remaining field for that group null. The other group and verified caps remain usable. Complete empty inventories are real zero; zero ceilings on a no-plan account do not erase retained usage. Overages remain visible in usage even though remaining is clamped to zero.

Snapshot headroom is against indexed stored bytes, including pending/deleting entries and each physical copy during handover. Capture placeholders have zero indexed bytes; private in-flight capture reservations are not exposed. This is not an available reservation for a new capture.

Advisory and uncached: concurrent changes can make the observation stale immediately, and observed_at is no consistency token. Creates count the effective template or snapshot disk floor. Resizes replace configured CPU/disk and allow reductions or unchanged overages after downgrade. A stopped resize consumes no running RAM; later start checks active or reserved count, CPU and RAM separately. Host fit and move consent remain separate. Existing mutation admission and 402 messages are unchanged. This read never stops, starts or resizes a computer.

Admission counts two things this read leaves out: creates and clones whose outcome was never heard, and the reservations held for seeds your own templates boot. See advisory on the response.

Requires the viewer role or higher.

get/account

Request

  • Base URL: https://app.mandala.computer/api/v1
  • URL: https://app.mandala.computer/api/v1/account
  • Auth: HTTP bearer

Response

Verified plan ceilings and independently complete or unknown quota totals.

scope'account' required

Whole-account aggregates, including for workspace-scoped viewers.

advisorytrue required

An observation, never an admission guarantee or reservation. Admission — of a create or clone, a start, restart, restore or resume, a resize, a move, a never-suspend pin or a template build — also counts two things left out here: a create or clone that reached a host whose answer was lost, or was a 5xx that cannot rule out a computer was built (see POST /computers), and a reservation of running vCPU and RAM for each seed one of your own templates boots for fast launches. The seed has 30 seconds to start, but its reservation stays charged until the platform confirms both that the seed is gone and that its permission to start has run out. While its host cannot be asked — unreachable, halted, removed or registered again — it stays charged. Either can make a 402 name more than these numbers show.

observed_atstring date-time required

UTC collection completion time; not a consistency token.

Changes

No recorded changes to this operation across all 1 revision of this API.