Workspaces
A workspace is an isolated space with its own private assets, API keys, credits and members; assets in one workspace are not visible from another.
Every account has a personal workspace, created when you register. You can also create or join any number of team workspaces. Manage them in the aixplain app at Settings.
Personal and team workspaces
| Personal | Team | |
|---|---|---|
| Members | Only you | You and the members you invite, each with a role |
| Private assets | Visible to you | Visible to all members |
| Credits | Your own balance | A shared team balance |
| API keys | Up to 10 | Up to 10 |
| Billing | You | Owners and Admins |
When you create a team workspace, you become its Owner. Invite members as Admin or Member.
Roles and permissions
A team workspace has one Owner. Admins have every Member permission plus billing, member and key management.
| Capability | Owner | Admin | Member |
|---|---|---|---|
| Create and use assets; use team and public assets | Yes | Yes | Yes |
| Transfer assets between workspaces | Yes | Yes | No |
| Create and view API keys | Yes | Yes | Yes |
| Delete API keys | Yes | Yes | Own keys only |
| Set rate limits on keys | Yes | Yes | No |
| Invite and remove members, assign roles | Yes | Yes | No |
| Manage payment, buy credits, set up automatic top-up | Yes | Yes | No |
| Redeem vouchers; view transactions and analytics | Yes | Yes | Yes |
To change a member's role, remove the member and invite them again with the new role.
How isolation works
- Private assets belong to the workspace where you created them. Public assets are visible from every workspace.
- Credits in one workspace cannot pay for usage in another.
- Anything you create, in the app or with a key, belongs to the active workspace. Switch workspaces with the workspace switcher in the app.
Transfer an asset
A transfer moves a private asset to another workspace you belong to. It is a move, not a copy: the source workspace loses access, and the destination workspace owns, edits and pays for the asset from then on.
To transfer, select the asset in the aixplain app, choose the destination workspace and confirm.
Organize teams
Create a separate team workspace when you need separate billing, access, data or compliance boundaries.
| Pattern | Structure | Use it to |
|---|---|---|
| Environments | One team per environment (dev, test, prod) | Isolate environments and track cost per stage. |
| Clients | One team per client | Keep client data and billing apart. |
| Departments | One team per department or project | Give each group its own budget and owner. |
Keep production workspaces to a few Admins, and remove inactive members on a schedule.
Next steps
- API keys: create keys for the active workspace.
- Rate limiting: cap what each key can spend.