AuthenticationError
pinecone.AuthenticationError
Stack trace
pinecone.AuthenticationError: Invalid API key provided. Authentication failed with status code 401.
Why it happens
This error occurs when the Pinecone client is initialized with an incorrect, expired, or missing API key. The server refuses connection because it cannot verify your identity or permissions.
Detection
Check for AuthenticationError exceptions when initializing Pinecone or making API calls; log the API key environment variable presence and correctness before requests.
Causes & fixes
API key environment variable is missing or not set
Set the environment variable PINECONE_API_KEY with your valid Pinecone API key before running your application.
API key is incorrect or has typos
Verify the API key string copied from Pinecone dashboard matches exactly, including case and no extra spaces.
Using an API key from a different Pinecone project or region
Ensure the API key corresponds to the correct Pinecone project and region you are connecting to.
Expired or revoked API key
Generate a new API key from the Pinecone console and update your environment variable accordingly.
Code: broken vs fixed
from pinecone import Pinecone
client = Pinecone(api_key="wrong_or_missing_key") # This line causes AuthenticationError
index = client.Index("example-index")
print(index.describe_index_stats())import os
from pinecone import Pinecone
client = Pinecone(api_key=os.environ["PINECONE_API_KEY"]) # Fixed: use env var for API key
index = client.Index("example-index")
print(index.describe_index_stats())Workaround
Catch AuthenticationError exceptions and prompt for API key input at runtime or fallback to a cached valid key if available.
Prevention
Use environment variables or secure vaults to manage API keys and validate keys on startup to avoid runtime authentication failures.