BlogsPineconeAPI Versioning

API Versioning

API Versioning

4
posts
2024

Pinecone has introduced a date-based API versioning schema managed via a custom header, allowing for incremental changes and a clear, predictable, and manageable API lifecycle. Stable API versions are supported for a minimum of 12 months. The Global Control Plane API has been launched, using a global URL for all control plane operations, supported within Python, Node, and Java clients, and also via Terraform and Pulumi. This update also includes broader availability with a new serverless region (us-east-1), updated SDKs with functionality to list record IDs or those with common ID prefixes (useful for RAG applications), self-serve SSO for enterprise customers, Python proxy support for SDKs, and a refreshed console with improved navigation and a new troubleshooting section in the docs.

2024

Introducing Pinecone API Versioning

7/18/2024

This post details Pinecone's adoption of a date-based API versioning strategy, moving away from traditional URL path versioning. It explains the rationale behind this choice, emphasizing stability, flexibility, and a clear release schedule with quarterly stable and release candidate versions. The post also outlines the support lifecycle for API versions and the corresponding SDK version mappings.

April Monthly Product Update

5/1/2024

This post announces the general availability of the Global Control Plane API, which allows users to manage Pinecone resources using a single global URL for all control plane operations. It also mentions the ongoing support for this API through Python, Node, and Java clients, as well as infrastructure-as-code tools like Terraform and Pulumi. The post also references the API lifecycle policy and migration guides.

Going Global: Building the Global Control Plane API

4/22/2024

This post announces the General Availability (GA) of the Global Control Plane API, which uses a global URL for all control plane operations, deprecating the legacy regional endpoints. The new API is designed to improve user experience by allowing management of resources across multiple Pinecone environments and projects with a single API key. It is backed by Google Cloud Spanner for high availability and ACID-compliant transactions, and a globally replicated Rust API server with Google Cloud's global load balancer for low-latency access. Usability improvements include standardized naming, updated API response types, and more accurate error reporting.

March Monthly Product Update

4/1/2024

This post introduces a new serverless region (us-east-1) for Pinecone, expanding availability. It also details updates to the Node.js and Python SDKs, specifically adding the ability to list record IDs with optional prefix filtering, which is beneficial for managing RAG applications. The Python SDK also gains proxy support. Additionally, the post mentions self-serve SSO for enterprise customers.