●Change8

Migrating to Pinecone Client v8.0.0

Version v8.0.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 11/18/2025

2
Breaking Changes
3
Migration Steps
4
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

upsert_from_dataframefetch_by_metadataupdateFilterBuilder

Breaking Changes

●Issue #1

Python 3.9 is no longer supported. Users must upgrade to Python 3.10 or later.

●Issue #2

The default behavior for the `namespace` parameter in GRPC methods has changed. It is no longer applied as a default value; when `namespace=None`, the parameter is omitted from requests, allowing the API to handle namespace defaults.

Migration Steps

  1. 1
    Ensure your environment uses Python 3.10 or later.
  2. 2
    If upgrading from versions prior to 5.1.0, remove `pinecone-client` from dependencies and add `pinecone` instead.
  3. 3
    Review GRPC client calls where `namespace=None` was previously relied upon to use the API default; these calls may now omit the namespace parameter entirely.

Release Summary

Version 8.x introduces dedicated read capacity configuration for serverless indexes and powerful new ways to query and update vectors using metadata filters. This release requires Python 3.10+ and introduces a breaking change regarding the default handling of the namespace parameter in GRPC methods.

Need More Details?

View the full release notes and all changes for Pinecone Client v8.0.0.

View Full Changelog