Workspaces

Workspaces are Magistrala's top-level isolation boundary — every user, device, channel, and group belongs to one. The CLI manages them through Atom's tenant API (cli/atom_commands.go's newWorkspacesCmd); see Architecture § Core Concepts for how the two map. All commands below require --token from login.

Create a workspace

magistrala-cli workspaces create <name> [--alias <alias>] [--attributes <json>] --token <token>

magistrala-cli workspaces create "Acme IoT" --alias acme-iot --token $TOKEN

Creating a workspace also seeds it with Magistrala's default Device Types, so newly created workspaces aren't empty of device-type choices.

List workspaces

magistrala-cli workspaces list --token <token>

Get a workspace

magistrala-cli workspaces get <workspace_id> --token <token>

{
  "id": "16a4ad70-a385-45c5-b50a-6d7e48d768d7",
  "name": "Acme IoT",
  "alias": "acme-iot"
}