Workspaces

Create a workspace

Makes a workspace on the account. Owners only, with an account-wide API key: a key confined to a workspace is refused (403), because it could otherwise make itself somewhere new to stand.

The name is trimmed, must be 1 to 40 characters with no ASCII control characters (U+0000 to U+001F and U+007F), and must not be one the account already uses; an account holds at most 500 workspaces. Each of those is a 400 with a sentence, as is any field but name.

Requires the owner role or higher.

post/workspaces

Request

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

Request body

namestring required

Its name: 1 to 40 characters after trimming, unique within the account.

Response

The new workspace.

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.