Organizations and Workspaces

Your Mistral AI account is structured around two levels: Organizations and Workspaces. Organizations handle billing, user management, and security. Workspaces give you isolated environments for projects, teams, or API usage.

An Organization is the top-level entity for your company or team. When you create an account, a default Organization is created automatically. If your company email matches an existing Organization with Email Domain Authentication enabled, you may be prompted to join it.

At the Organization level, administrators can manage:

• Billing for all Workspaces
• Subscriptions (Le Chat and Studio)
• Members and role assignments
• Security settings (SSO, domain authentication)
• Privacy and data handling preferences
• Audit logs (Enterprise)

Every Organization has a unique Organization ID that you can reference in API calls or when contacting support.

A Workspace is an isolated environment within your Organization. Each Workspace has its own API keys, member access list, and usage tracking.

Workspaces are useful for:

• Separating environments: keep development, staging, and production isolated
• Scoping API keys: keys created in a Workspace only access that Workspace's resources
• Tracking costs: monitor usage and spending per team or project
• Sharing resources: datasets and batch jobs are shared among Workspace members

Workspace roles are independent from Organization roles. A user with the Member role at the Organization level can be an Admin within a specific Workspace.

You can create a new Organization at any time:

1. Click on your organization name in the top-left corner of Studio.
2. Click Create in the Organizations section.
3. Enter a name and accept the terms of service.

Only Organization Admins can create Workspaces.

1. Open Admin›Workspaces ↗.
2. Click New workspace.
3. Configure the Workspace:
   • Name (required): a clear label for the Workspace.
   • Description (optional): context about the Workspace's purpose.
   • Members (optional): add Organization members now, or later.
4. Click Create.

You can also create Workspaces from Studio by clicking your organization name and selecting + Add in the Workspaces section.

To add or manage members in a Workspace, users must already be members of your Organization.

1. Open the Workspace settings.
2. Click the Members tab.
3. Click Add Members and select users from your Organization.
4. Assign a Workspace role (Admin or Member).

Changes apply immediately. You can update roles or remove members at any time.

Workspace Admins can customize:

• Name and description
• Icon (optional emoji)
• Permissions: control whether members can create API keys
• Spending limits: set a monthly spending cap for the Workspace

If you no longer need a Workspace, you can archive it from the Workspace settings.