Organizations and Workspaces

SteelEngine organizes your work in two scopes: organizations and workspaces. Both have their own URL slugs, and every dashboard URL is built from the pair: /<orgSlug>/<workspaceSlug>/....

Concepts

Organization

The top-level container. Owns billing, members, plan tier, and one or more workspaces. Addressed by an immutable URL slug.

Workspace

A project scope inside an org. Holds workflows, chats, knowledge bases, databases and tables, files, and scheduled tasks. Also slug-addressed.

When you sign up, SteelEngine automatically creates a personal organization for you and a default workspace inside it. You don't have to choose a name or pick a plan — your first authenticated visit to / is enough.

Your personal org is a real organization with the Free plan applied. You can rename it later, invite teammates, and upgrade it to a paid plan — all the same controls that team-created orgs have. The only difference is that the slug was generated for you (e.g. mild-owl, prime-horse) instead of derived from a name you typed.

You'll know you've landed on it when the URL looks like:

https://app.steelengine.com/<your-personal-org-slug>

That page is your organization dashboard — you enter a workspace from there.

You can belong to additional organizations by invitation. Each organization keeps its own billing, members, workspaces, credentials, and access-control settings.

Organization Dashboard

Signing in lands you on the organization dashboard at /<orgSlug>. It lists the workspaces you can access and is the home for organization-level management — you enter a workspace from there, and admins manage members, billing, and settings from its tabs.

Which tabs you see depends on your organization role:

Tabs	Admin	Supervisor	Member
Overview, Workspaces, General	✓	✓	✓
Members, Workspace Access	✓	✓	—
Groups, Models, Billing, SSO, Branding	✓	—	—

Organization admins see every workspace in the organization; supervisors and members see only the workspaces they've been explicitly granted access to. Any member can leave an organization, as long as they aren't its last admin.

URL Anatomy

Every dashboard URL is composed of two slug segments after the host:

https://app.steelengine.com/<orgSlug>/<workspaceSlug>/...

Segment	Source	Mutable?
`<orgSlug>`	Generated from the organization name on creation, or a curated word-pair for personal orgs	Editable in Settings → Subscription (renaming an org breaks old links to that org)
`<workspaceSlug>`	A 6-character random slug generated when the workspace is created (e.g. `yxc35g`)	Immutable — display names live in the workspace `name` field and can be freely renamed without breaking URLs

Both slugs are unique within their parent scope:

Org slug: globally unique across the platform
Workspace slug: unique within an organization (so the same yxc35g could exist under two different org slugs)

When you rename an organization, the slug changes too. Old bookmarks and external links that pointed at the old slug will return a 404. Avoid renaming production orgs without coordinating with anyone who has bookmarks.

Switching Organizations and Workspaces

Use the workspace switcher at the top of the sidebar to move between scopes:

Switch workspace — Click the workspace name. A dropdown lists every workspace you have access to, grouped by organization. Picking one navigates to /<orgSlug>/<newWorkspaceSlug>/home and makes that organization active for org-scoped settings.
Switch organization — Choose any workspace under another organization in the same dropdown. SteelEngine keeps your memberships separate, so plan limits, members, credentials, SSO, and access-control settings come from the organization in the URL.
Create new workspace — At the bottom of the dropdown. Adds a workspace inside the organization you're currently viewing.
Invite members — Below "Create new workspace". Sends an invitation scoped to the organization you're currently viewing.

The organization dashboard at /<orgSlug> offers the same navigation — every workspace you can access is listed there.

You can be a member of multiple organizations at once. Accepting an invitation adds that organization to your account instead of replacing your personal organization or forcing you to leave another team.

Upgrading from Personal to Team

When you upgrade your personal organization to a paid plan, SteelEngine first prompts you to choose an organization name. The auto-generated word-pair slug works for solo use but is awkward to share with a team — the prompt is your chance to pick something readable.

The flow:

From Settings → Subscription, click Upgrade on the Pro or Max plan
The Organization Name dialog opens with your current name pre-filled
As you type, SteelEngine checks slug availability in real time and shows a green check or a red conflict
Confirm to rename the org and continue to checkout

Renaming during this flow updates both the display name and the URL slug. If you'd rather keep the original slug — for example, because you've already shared links — leave the field unchanged and click confirm. The slug only changes when you actually edit the name.

API and Slug Considerations

User-facing dashboard URLs use slugs: /<orgSlug>/<workspaceSlug>/...
Admin and execution APIs use UUIDs (e.g. workspaceId query parameters in /api/v1/logs). The internal IDs are stable across renames, while slugs can change. See API Reference for details.
Webhooks and integrations stored on a workflow are addressed by the workflow's UUID, not by the workspace slug — they continue to work after a slug rename.

FAQ

Common Questions

You can't. The bootstrap is mandatory: every account must belong to at least one organization, and the personal org is the fallback. If you upgrade to a paid team org and want to leave the personal one behind, you can rename it or simply ignore it — but you can't delete the only org that contains you.

Yes. Invitations add another organization membership to your account. Use the workspace switcher to jump between workspaces across orgs; the active org follows the URL, so settings and billing apply to the organization you're viewing.

Yes. Organization admins can set per-workspace usage limits from the organization dashboard's Billing tab. Each workspace's usage is tracked against its own limit.

Yes. Any member can remove themselves from an organization, as long as they aren't its last admin. You also can't leave your only organization — every account must belong to at least one.

Not currently from the UI. Workspaces are created inside an organization and stay there. If you need to consolidate workspaces under a different org, contact support — we can migrate the underlying records, but external integrations bound to the old workspace ID will need to be re-pointed.

A two-word combo like `mild-owl`, `prime-horse`, or `quiet-river`, drawn from a curated word-pair list to avoid offensive or confusing combinations. Slugs are globally unique — if your generated pair is taken, SteelEngine regenerates until it finds a free one.

No. Workspace slugs are 6-character random strings generated at creation time and are immutable. The display name is freely editable in Settings → Workspace, and the rename only affects what shows in the sidebar and switcher — the URL slug stays stable.

SteelEngine generates short random slugs to keep URLs short, avoid name collisions across workspaces in the same org, and keep the URL stable across renames. If you'd prefer a memorable URL, the org slug (which IS derived from the name) carries that signal — `acme-corp/yxc35g/...` reads as 'Acme Corp's first workspace' once you know the convention.

Not across organizations — but they can span workspaces within one. Workspace keys cover a single workspace, and organization admins can create organization keys scoped to any set of workspaces or individual workflows, each with its own read/write/admin level (Organization Settings → API Keys). To run executions in workspaces belonging to two different orgs, you'll still need a key from each.

Use a separate team organization rather than renaming the personal one. Once you're invited to that team org, the workspace switcher shows its workspaces under their own organization heading so you can move between the personal org and team org without losing either membership.