Skip to main content
Creating and managing Workspaces
Updated over 2 weeks ago

This guide will walk you through the process of creating, editing, and managing Workspaces in your Anthropic Console account.

Creating a New Workspace

Please Note: Only Organization Admins can create new Workspaces.

  1. Log in to your Anthropic Console account.

  2. Navigate to the Workspaces section by clicking on "Settings" in the top level menu and selecting “Workspaces” from the left side bar.

  3. Click the "Add Workspace" button near the top right of the page.

  4. In the modal that appears, enter a name for your new Workspace, and select a color assignment. This color assignment will be used to help visually identify your workspace in the Anthropic Console.

  5. Click "Create" to finalize the new Workspace.

Your new Workspace will now appear in the list of Workspaces.

Please Note: You are limited to 100 workspaces per organization.

Editing Workspace Settings

  1. From the Workspaces list, click on the ellipsis next to the Workspace you want to edit.

  2. Select “Edit details”.

  3. You can modify the following settings:

    • Workspace Name

    • Color

  4. After making your changes, click "Save" to apply them.

Please note: The default Workspace is not editable and cannot be removed.

Adding members in a Workspace

  1. Navigate to the desired Workspace's details page by clicking on it from the Workspaces list.

  2. Click on the “Members” tab.

  3. Click on “Add to Workspace” near the top right of the page.

  4. Choose the individual you’d like to add from the list of your organization’s members.

  5. Assign a Workspace role for this member.

  6. Confirm your selections by clicking “Add to Workspace

Please Note: Organization Admins are automatically added as Workspace Admin to every Workspace. Organization Billing role holders are automatically granted ability to see cost, usage, and limit values for all Workspaces, but can be upgraded to the Organization Admin role.

Deleting members in a Workspace

  1. Click the trash can icon next to the member to remove them from your Workspace.

Please Note: Organization Admins and Organization Billing are automatically granted permissions on all Workspaces and cannot be removed from Workspaces.

Managing API Keys in a Workspace

  1. Navigate to the desired Workspace's details page by clicking on it from the Workspaces list.

  2. Click on the "API Keys" tab.

  3. To create a new API key for this Workspace:

    • Click "Create Key"

    • Give the key a descriptive name

    • Click "Create Key"

  4. To revoke an existing API key:

    • Find the key in the list

    • Click the ellipsis next to it

    • Select "Disable API Key" or “Delete API Key”

      • Please note: Deleting an API key is a permanent action and cannot be undone.

    • Confirm the action

Please Note: API keys are tied to the Workspace they're created in and cannot be moved between Workspaces.

Setting Workspace Rate Limits

  1. Navigate to the desired Workspace's details page by clicking on it from the Workspaces list.

  2. Click on the "Limits" tab.

  3. Set a limit for each model tier and limit type by clicking on the pencil icon next to each option.

  4. Workspace Spend Limits can be reset to the organization rate limit by clicking the “Refresh” icon next to the rate limit you previously set for the Workspace.

Please note: If unset, rate limits will inherit from the organization's rate limit. If set, both the Workspace and organization limits apply.

Setting Workspace Spend Limits or Notifications

  1. Navigate to the desired Workspace's details page by clicking on it from the Workspaces list.

  2. Click on the "Limits" tab.

  3. Choose one of the following:

    • Select “Change Limit” to set a specific spend limit for this Workspace.

      • Please note: You can only set a spend limit that is lower than your organization’s limit. If unset, your spend limit defaults to the organization’s limit.

    • Select “Add notification” to set up an email notification when the Workspace spend reaches a specific amount.

Viewing Workspace Usage and Costs

  1. Navigate to the Usage or Cost Reports

  2. Choose to view by an individual Workspace, or by “All Workspaces”.

Archiving a Workspace

If you no longer need a Workspace but want to retain its historical data:

  1. Navigate to the Workspaces page.

  2. Click the ellipsis next to the Workspace you would like to archive.

  3. Confirm that you want to archive the Workspace.

Please note: Archiving a Workspace will archive all API keys in the Workspace. This action cannot be undone.

Managing the Default Workspace

Every organization has a default Workspace that cannot be renamed, archived, or deleted. To view API keys associated with the default Workspace:

  1. Navigate to the Workspaces list.

  2. Click on "Default" in the list.

Please note: You can view your default Workspace’s limits from the Limits settings.

Did this answer your question?