Workspaces

How to create, rename, and delete workspaces in IoTMan.

A workspace is an isolated container for all your IoTMan resources: MQTT connectors, HTTP endpoints, sensor data, and OAuth clients. Every user starts with one workspace; you can create more to separate environments or projects.

Switching workspaces

Click the workspace name in the top-left of the sidebar. A dropdown lists all workspaces you belong to. Click any entry to switch.

Creating a workspace

1. Open the workspace dropdown.
2. Click + New workspace.
3. Type a name and press Enter.

The new workspace becomes active immediately.

Workspace settings

Click the gear icon (⚙) next to the workspace name to open the workspace settings panel. From here you can rename the workspace, manage members, and delete the workspace.

Renaming a workspace

1. Open workspace settings (⚙).
2. Edit the name in the field that appears.
3. Press Enter to save, or Escape to cancel.

Requires Admin role.

Deleting a workspace

1. Open workspace settings (⚙).
2. Click Delete workspace… and confirm.

Deletion is permanent and removes all resources inside the workspace — sensor data, MQTT connectors, HTTP endpoints, and OAuth clients. You cannot delete your last workspace.

Requires Admin role.

Members

The members section lists everyone with management access to the workspace and their role. Members can configure connectors, manage OAuth2 clients, and view data depending on their role.

Members are distinct from end-users — people who access your protected data endpoints or external services using IoTMan-issued tokens, but who have no workspace management role. End-users are managed in the Access tab.

Inviting a member

1. Open workspace settings (⚙).
2. Click Invite.
3. Enter the user's email and select a role.
4. Click Send invite.

An invitation email is sent. The link expires after 7 days. Pending invitations appear below the member list — click × to cancel one.

Requires Admin role.

Removing a member

Click the remove icon on a member row. The user loses access immediately.

Requires Admin role.

Roles

Each workspace member has one of three roles: