Workspaces

Rename a workspace

Renames a workspace. Its id does not change, so the API keys confined to it and the computers in it are untouched. Owners only, with an account-wide API key: a key confined to a workspace is refused (403), its own workspace included.

The name follows the rules a create does, and a name the account already uses is a 400, as is any field but name. An id this credential cannot see is a 404, the same as one that does not exist.

Requires the owner role or higher.

patch/workspaces/{id}

Request

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

Path parameters

idstring required

The workspace id.

Request body

namestring required

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

Response

The workspace, renamed.

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.