Configure AI Models for Teams | Pieces Settings

Learn how to manage model access and API keys (BYOK) in the Models section (organization management for AI).

The Models section is the organization management area for AI. From here you control which models are available, enable or disable providers (Google, OpenAI, etc.), and set up API keys. All settings sync to team members' Pieces Desktop and PiecesOS.

With BYOK enabled, your organization chooses exactly which models are available—pick and choose specific models per provider through the allow-list, and manage credentials in the API Keys tab. These organization-level controls live here so members get a consistent, governed model set.

Models page with provider sections, model lists, and toggles

Models page showing provider sections (Google, OpenAI) with model lists and toggles

All model settings configured here automatically sync to team members' Pieces Desktop and PiecesOS installations.

How to Get to the Models Page

Go to [portal.pieces.app](https://portal.pieces.app) and sign in. Or from Pieces Desktop, click your `User Profile` → `Settings` → `Account` to reach your workspace. In the *sidebar*, click the *organization dropdown* at the top and select your organization. Click `Models` in the *sidebar* navigation. The Models page opens with the *Models* tab selected. Use the `API Keys` tab to add provider credentials.

Enabling the Customized Model Allow-List

By default, all models from enabled providers are available. To control which providers and models members can use, you must first enable the customized model allow-list. The provider toggles (Google, OpenAI, etc.) are only active when the allow-list is enabled.

On the Models page, find the *Customized Model Allow-List* toggle and turn it **on**. A save reminder appears at the bottom of the page. Click `Save` to apply. The provider sections below become active so you can enable or disable providers and select specific models.

Enabling or Disabling a Provider (Google, OpenAI, etc.)

The customized model allow-list must be enabled for provider toggles to be active. See the section above.

Each provider (Google, OpenAI, Anthropic, etc.) has a toggle at the top of its section. Turn it on to make that provider's models available; turn it off to disable them.

Provider sections with on/off toggles for Google, OpenAI, and others

Provider sections with on/off toggles for Google, OpenAI, and other providers

Ensure the *Customized Model Allow-List* toggle is **on** near the top of the Models page. Provider toggles are inactive until the allow-list is enabled. On the Models page, scroll to the provider you want to change (e.g., *Google*, *OpenAI*). Use the toggle switch at the top right of the provider section. Turn it **on** to enable that provider's models for your organization, or **off** to disable them. A save reminder appears at the bottom of the page. Click `Save` to apply. Changes sync to all team members.

Selecting Allowed Models

With the allow-list and provider toggles configured, choose which specific models members can use.

On the Models page, scroll to each enabled provider (e.g., *Google*, *OpenAI*). Use the checkboxes or controls next to each model to include or exclude it. Only models you explicitly allow will be available to members. A save reminder appears at the bottom of the page. Click `Save` to apply.

Adding API Keys for Providers

To use models from OpenAI, Anthropic, or GCP, you need to add API keys. Switch to the API Keys tab within Models.

On the Models page, click the `API Keys` tab at the top. Find the provider section (OpenAI, Anthropic, GCP) and click `+ Add API Key`. Enter your credentials and click `Save`. Switch back to the *Models* tab to enable that provider and choose which models to use.

For full API key instructions, see API Keys Settings.

Next Steps

Add credentials in API Keys, or configure Long Term Memory for context capture and default models.