Templates

List templates

The images a computer can be built from, with the CPU and memory each one defaults to and the disk it cannot be built below. For the templates we publish, name is what you pass as template to create; for one you published, pass its ref — a short name is not resolved to your templates and falls back to the default template, or, while this list is short and carries X-GC-Incomplete, is refused with a 503 (see template on POST /computers).

If a host cannot be reached the list may be short, and then carries X-GC-Incomplete; this listing answers with what it has rather than a 503.

A template is an image rather than an operating system — hermes, claude and openclaw are the base Linux desktop with an agent already installed, coding is the same desktop with ten coding-agent CLIs on it (Claude Code, Codex, Gemini CLI, Qwen Code, opencode, goose, Cline, Aider, Open Interpreter and a Cursor CLI installer), managed-agents runs Anthropic’s Claude Managed Agents self-hosted worker as a service once its environment key is bound as a secret, and omarchy is a different desktop entirely (Arch + Hyprland) — so read label rather than assuming this list is a choice of OS. Only the templates your plan may launch are returned.

omarchy is a Wayland desktop, and that is worth knowing before you drive one. Screenshots, input and exec behave exactly as they do everywhere else: they are taken at the hypervisor, below the guest, so nothing about them changes. The window, window-action and clipboard routes are answered through the compositor instead of through X, which shows up in two places — a window id is the compositor address rather than an X window id (still opaque, still handed back the same way), and moving or resizing a window the compositor is TILING is refused rather than silently ignored, because a tiled window’s geometry belongs to the layout. Float it first.

Requires the viewer role or higher.

get/templates

Request

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

Response

Every template available to your account.

namestring

The short name of the template, and what a computer reports as its own template. Accepted as template on a create for the templates we publish; one you published is named by its ref.

refstring

The pinned namespace/name@version for this template. Also accepted as template on a create, and the form to use when it matters that you get exactly this template and this version — a short name resolves to whatever the host currently has under it.

labelstring

Human-readable name.

osstring

linux. (windows is not currently offered on any plan.)

desktopstring

The display protocol this template’s desktop speaks: wayland, x11, or absent (X11, or a host too old to say); branch on === "wayland". Screenshots, input and exec are identical either way — they are taken below the guest — but two things differ on a Wayland template. A window id is the compositor’s address rather than an X window id (opaque and handed back the same way, but not comparable across the two), and moving or resizing a window the compositor is TILING is refused rather than silently ignored, because a tiled window’s geometry belongs to the layout. Absent also on a host deployed before this field existed, which is why it is not defaulted to x11 here.

iconstring

A slug naming a mark this console has an asset for, e.g. claude or debian. Cosmetic — nothing here validates it against a list, and an unrecognised value or none just means the template has no particular icon.

cpuinteger

The default this template builds at.

ram_mbinteger
disk_gbinteger

The FLOOR this template builds at, not a default like the two above — a create asking for less is raised to this and charged at it.

Changes

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