Workspaces

List workspaces

The account’s workspaces, oldest first. A workspace partitions the account’s computers: an API key issued against one reaches that workspace’s computers only, and a computer’s workspace_id names the workspace it is in.

An API key confined to a workspace lists that one workspace and no other. An account-wide key sees them all, whatever its holder’s role.

A member or owner can move a computer with an account-wide credential using PUT /computers/{id}/workspace, or in the dashboard’s Settings → General → Workspace, to another workspace or to none. The computer must be stopped with no saved session, and have no snapshots, no secret bindings and no proxy credentials. Once it has moved, API keys confined to its old workspace get 404 for it and keys confined to the new one can reach it; its events, webhooks included, follow it to the new workspace; and its desktop and share credentials are replaced, so links from before stop working.

Requires the viewer role or higher.

get/workspaces

Request

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

Response

The workspaces, oldest first.

idstring required

wsp- and twelve hex characters. What a computer’s workspace_id names.

namestring required

Its name, unique within the account. Up to 40 characters.

created_atstring required

RFC 3339 timestamp.

Changes

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