List builds
Every build this account has started that the fleet still holds a record of, newest first. Needs an account-wide key: one confined to a workspace is a 403.
This is a fan-out across the fleet, so it fails closed the way GET /computers and GET /snapshots do: a hypervisor that cannot be reached makes the answer 503 rather than short. allow_partial is the way through.
Requires the viewer role or higher.
Request
- Base URL: https://app.mandala.computer/api/v1
- URL: https://app.mandala.computer/api/v1/builds
- Auth: HTTP bearer
Query parameters
Accept a listing known to be short. Without it this endpoint answers 503 when a hypervisor holding some of your things cannot be reached, because a short list is not a smaller truth — it reads exactly like the missing ones were deleted, and the obvious next thing a script does with something that has disappeared is tidy it up. A short build listing has no rows marking what is gone: the builds a silent host was holding are simply not there. Nothing on this tier records which hypervisor ran which build — a build is not a thing you act on afterwards, so there was never anything to route to it — so there is no cache to name what is missing here, and no count to give you either. Read the X-GC-Incomplete response header rather than the rows: it is present only when the listing is short, and its value here is always 0, because nothing can count what is missing. Any other value of this parameter is read as absent rather than refused.
Response
Your builds.
Changes
No recorded changes to this operation across all 1 revision of this API.