Once you have created your integration with Pinecone, specify a source tag when instantiating clients with Pinecone SDKs, or pass a source tag as part of the User-Agent header when using the API directly.

Anyone can create an integration, but becoming an official Pinecone partner can help accelerate your go-to-market and add value to your customers.

Source tag naming conventions

Your source tag must follow these conventions:

  • Clearly identify your integration.
  • Use only lowercase letters, numbers, underscores, and colons.

For example, for an integration called “New Framework”, "new_framework" is valid, but "new framework" and "New_framework" are not valid.

Specify a source tag

Pinecone SDKRequired version
Pythonv3.2.1+
Node.jsv2.2.0+
Javav1.0.0+
Gov0.4.1+
# REST client
from pinecone.grpc import PineconeGRPC as Pinecone

pc = Pinecone(
    api_key="YOUR_API_KEY", 
    source_tag="YOUR_SOURCE_TAG"
)

# gRPC client
from pinecone.grpc import PineconeGRPC

pc = PineconeGRPC(
    api_key="YOUR_API_KEY", 
    source_tag="YOUR_SOURCE_TAG"
)