API Keys Settings

The API Keys tab is one of two tabs within the Models section—the organization management area for AI configuration. From the API Keys tab, you configure credentials for model providers (OpenAI, Anthropic, GCP). These API keys automatically sync to all team members' Pieces Desktop and PiecesOS installations, enabling your team to use these services without individual configuration.

API Keys tab with OpenAI, Anthropic, and GCP configuration sections

API Keys tab showing OpenAI, Anthropic, and GCP configuration sections

All API keys configured here automatically sync to team members' Pieces Desktop and PiecesOS installations, allowing your entire team to use these AI services with organization-managed credentials.

How to Get to the API Keys Tab

Go to [portal.pieces.app](https://portal.pieces.app) and sign in. Select your organization from the *sidebar* dropdown if needed. Click `Models` in the *sidebar* navigation. On the Models page, click the `API Keys` tab at the top.

Configuring API Keys

Set up API credentials for model providers. Each provider has its own configuration section: OpenAI, Anthropic (Claude), and GCP Configuration.

Adding a new API key in the configuration form

Configuring OpenAI

Set up OpenAI API credentials for your organization.

Find the *OpenAI* section with the description "API credentials and organization settings." Click the `+ Add API Key` button next to the OpenAI section. Fill in the form with: * **Name** (required) — A descriptive name (e.g., "Personal Pro", "Production") * **API Key** (required) — Your OpenAI API key * **Organization ID** (optional) — For OpenAI org-specific usage * **Project ID** (optional) — For project-specific usage * **Custom API URL** (optional) — Defaults to `https://api.openai.com` A save reminder appears at the bottom of the page. Click `Save` to save your OpenAI credentials. The credentials will sync to all team members.

Configuring Anthropic (Claude)

Set up Anthropic Claude API credentials for your organization.

Find the *Anthropic (Claude)* section with the description "API credentials." Click the `+ Add API Key` button next to the Anthropic section. Fill in the Anthropic-specific credential form with your API key and any required configuration details. A save reminder appears at the bottom of the page. Click `Save` to save your Anthropic credentials.

Configuring GCP

Set up GCP API keys and Vertex AI service accounts for your organization.

Find the *GCP Configuration* section with the description "Manage GCP API keys and Vertex AI service accounts." Click the `+ Add API Key` button next to the GCP Configuration section. Fill in the GCP-specific credential form with your API key and service account details. A save reminder appears at the bottom of the page. Click `Save` to save your GCP credentials.

Managing API Keys

View, edit, and remove existing API key configurations.

Edit API Key form with name, key, and optional fields

Edit API Key form showing name, API key, and optional fields

Review all configured API keys in their respective sections. Each section shows "No API keys configured" if none are set up. Use the edit icon to modify an existing key or the delete icon to remove it. When editing, you can update the name, API key, Organization ID, Project ID, or Custom API URL. A save reminder appears at the bottom of the page. Click `Save` to apply your changes. A warning appears if you have unsaved changes when navigating away.

Next Steps

Now that you understand API keys settings, explore Models Settings to configure processing mode and model access, or check out Features Settings to configure team-wide feature toggles.