# Pinecone Docs: Pinecone Database Reference 2026-07 (latest)

> Official Pinecone documentation for the vector database, Assistant, inference APIs, SDKs, and building production search and AI applications.

## 2026-07 (latest)

### APIs

- [API reference](https://docs.pinecone.io/reference/api/introduction.md): Pinecone API reference overview for Database, Inference, and Admin endpoints with supported SDKs including Python, Node.js, Java, and Go.
- [Authentication](https://docs.pinecone.io/reference/api/authentication.md): Pinecone API authentication guide covering API key generation, SDK client setup, and HTTP header configuration for authorized requests.
- [Pinecone API versioning](https://docs.pinecone.io/reference/api/versioning.md): Learn how Pinecone versions its APIs by release date, how long each stable version is supported, and how to set the X-Pinecone-Api-Version header.
- [Errors](https://docs.pinecone.io/reference/api/errors.md): Look up the HTTP status codes the Pinecone API returns, what each 2xx success and 4xx or 5xx error means, and where to handle them in production.

#### Database limits

- [Pinecone Database limits overview](https://docs.pinecone.io/reference/api/database-limits.md): Reference for Pinecone Database rate, object, operation, and identifier limits, plus known index and serverless limitations.
- [Rate limits](https://docs.pinecone.io/reference/api/database-limits/rate-limits.md): Request-per-second, monthly usage, and model throughput limits for Pinecone Database serverless indexes, and the 429 errors returned when you exceed them.
- [Object limits](https://docs.pinecone.io/reference/api/database-limits/object-limits.md): Limits on the number and size of Pinecone Database projects, indexes, namespaces, storage, backups, and collections, by plan.
- [Operation limits](https://docs.pinecone.io/reference/api/database-limits/operation-limits.md): Fixed limits on Pinecone Database operations, including upsert, update, import, query, fetch, and delete batch sizes and metadata filter expressions.
- [Identifier limits](https://docs.pinecone.io/reference/api/database-limits/identifier-limits.md): Maximum length and allowed characters for Pinecone identifiers, including organization, project, index, namespace, and record names.
- [Known limitations](https://docs.pinecone.io/reference/api/known-limitations.md): Known limitations and feature restrictions for Pinecone indexes, including upsert consistency, metadata rules, and serverless caveats.

### Database

#### Indexes

- [List indexes](https://docs.pinecone.io/reference/api/2026-07/control-plane/list_indexes.md): List all indexes in a project.
- [Create an index](https://docs.pinecone.io/reference/api/2026-07/control-plane/create_index.md): Create a Pinecone index. Define the schema for your index — dense vector, sparse vector, and full-text search fields — and, optionally, the deployment infrastructure (managed serverless or BYOC). To create an index with an integrated embedding model, use [Create an index with integrated embedding](h…
- [Create an index with integrated embedding](https://docs.pinecone.io/reference/api/2026-07/control-plane/create_for_model.md): Create an index with integrated embedding.
- [Describe an index](https://docs.pinecone.io/reference/api/2026-07/control-plane/describe_index.md): Get a description of an index.
- [Delete an index](https://docs.pinecone.io/reference/api/2026-07/control-plane/delete_index.md): Delete an existing index.
- [Configure an index](https://docs.pinecone.io/reference/api/2026-07/control-plane/configure_index.md): Configure an existing index. For guidance and examples, see [Manage indexes](https://docs.pinecone.io/guides/manage-data/manage-indexes).
- [Get index stats](https://docs.pinecone.io/reference/api/2026-07/data-plane/describeindexstats.md): Return statistics about the contents of an index, including the vector count per namespace, the number of dimensions, and the index fullness.

#### Namespaces

- [List namespaces](https://docs.pinecone.io/reference/api/2026-07/data-plane/listnamespaces.md): List all namespaces in a serverless index.
- [Create a namespace](https://docs.pinecone.io/reference/api/2026-07/data-plane/createnamespace.md): Create a namespace in a serverless index.
- [Describe a namespace](https://docs.pinecone.io/reference/api/2026-07/data-plane/describenamespace.md): Describe a namespace in a serverless index, including the total number of vectors in the namespace.
- [Delete a namespace](https://docs.pinecone.io/reference/api/2026-07/data-plane/deletenamespace.md): Delete a namespace from a serverless index. Deleting a namespace is irreversible; all data in the namespace is permanently deleted.

#### Namespace aliases

- [List namespace aliases](https://docs.pinecone.io/reference/api/2026-07/data-plane/list_namespace_aliases.md): List the namespace aliases in a serverless index, ordered by name. Filter by name prefix or by target namespace.
- [Create a namespace alias](https://docs.pinecone.io/reference/api/2026-07/data-plane/create_namespace_alias.md): Create an alias that resolves to an existing namespace in the index. Reads through the alias are served from its target namespace; writes to an alias name are rejected. Many aliases can resolve to the same namespace.
- [Describe a namespace alias](https://docs.pinecone.io/reference/api/2026-07/data-plane/describe_namespace_alias.md): Get an alias and the namespace it resolves to.
- [Repoint a namespace alias](https://docs.pinecone.io/reference/api/2026-07/data-plane/repoint_namespace_alias.md): Update the namespace an alias resolves to. The change is atomic: the target is validated in the same transaction that rewrites the alias, and on failure the alias keeps its current target.
- [Delete a namespace alias](https://docs.pinecone.io/reference/api/2026-07/data-plane/delete_namespace_alias.md): Remove an alias. The target namespace and its data are unchanged. Reads that still use the alias name are treated as reads of a nonexistent namespace (empty results, not an error), so migrate readers off the alias first.

#### Vectors

- [Upsert records](https://docs.pinecone.io/reference/api/2026-07/data-plane/upsert.md): Upsert records into a namespace. If a new value is upserted for an existing record ID, it will overwrite the previous value.
- [Upsert text](https://docs.pinecone.io/reference/api/2026-07/data-plane/upsert_records.md): Upsert text into a namespace. Pinecone converts the text to vectors automatically using the hosted embedding model associated with the index.
- [Fetch records](https://docs.pinecone.io/reference/api/2026-07/data-plane/fetch.md): Look up and return records by ID from a single namespace. The returned records include the vector data and/or metadata. For on-demand indexes, since vector values are retrieved from object storage, fetch operations may have increased latency. If you only need metadata or IDs, consider using the quer…
- [Fetch records by metadata](https://docs.pinecone.io/reference/api/2026-07/data-plane/fetch_by_metadata.md): Look up and return records by metadata from a single namespace. The returned records include the vector data and metadata. For guidance and examples, see [Fetch data](https://docs.pinecone.io/guides/manage-data/fetch-data).
- [Update a record](https://docs.pinecone.io/reference/api/2026-07/data-plane/update.md): Update records by ID or by metadata in a namespace. Updating by ID changes the vector and/or metadata of a single record. Updating by metadata changes metadata across multiple records using a metadata filter. If a vector value is included, it will overwrite the previous value. If `set_metadata` is i…
- [Delete records](https://docs.pinecone.io/reference/api/2026-07/data-plane/delete.md): Delete records by id or by metadata from a single namespace.
- [List record IDs](https://docs.pinecone.io/reference/api/2026-07/data-plane/list.md): List the IDs of records in a single namespace of a serverless index. An optional prefix can be passed to limit the results to IDs with a common prefix.

#### Search

- [Search with a vector](https://docs.pinecone.io/reference/api/2026-07/data-plane/query.md): Search a namespace using a query vector. It retrieves the ids of the most similar items in a namespace, along with their similarity scores.
- [Search with text](https://docs.pinecone.io/reference/api/2026-07/data-plane/search_records.md): Search a namespace with a query text, query vector, or record ID and return the most similar records, along with their similarity scores. Optionally, rerank the initial results based on their relevance to the query.

#### Documents

- [Upsert documents](https://docs.pinecone.io/reference/api/2026-07/data-plane/upsert_documents.md): Upsert documents into a namespace.
- [Search documents](https://docs.pinecone.io/reference/api/2026-07/data-plane/search_documents.md): Search for documents in a namespace using one or more scoring methods (dense vector, sparse vector, text, or query string similarity).
- [Fetch documents](https://docs.pinecone.io/reference/api/2026-07/data-plane/fetch_documents.md): Fetch documents from a namespace. Returns the specified fields for each document. Exactly one of `ids` or `filter` must be specified.
- [List documents](https://docs.pinecone.io/reference/api/2026-07/data-plane/list_documents.md): List documents in a namespace.
- [Update documents](https://docs.pinecone.io/reference/api/2026-07/data-plane/update_documents.md): Apply partial updates to documents in a namespace. Documents are selected either per ID with `documents`, or in bulk with `filter`.
- [Delete documents](https://docs.pinecone.io/reference/api/2026-07/data-plane/delete_documents.md): Delete documents from a namespace. Exactly one of `ids`, `filter`, or `delete_all` must be specified.

#### Imports

- [Start import](https://docs.pinecone.io/reference/api/2026-07/data-plane/start_import.md): Start an asynchronous import of vectors from object storage into an index.
- [List imports](https://docs.pinecone.io/reference/api/2026-07/data-plane/list_imports.md): List all recent and ongoing import operations.
- [Describe an import](https://docs.pinecone.io/reference/api/2026-07/data-plane/describe_import.md): Return details of a specific import operation.
- [Cancel an import](https://docs.pinecone.io/reference/api/2026-07/data-plane/cancel_import.md): Cancel an import operation if it is not yet finished. It has no effect if the operation is already finished.

#### Backups

- [Create a backup of an index](https://docs.pinecone.io/reference/api/2026-07/control-plane/create_backup.md): Create a backup of an index.
- [List backups for all indexes in a project](https://docs.pinecone.io/reference/api/2026-07/control-plane/list_project_backups.md): List all backups for a project.
- [List backups for an index](https://docs.pinecone.io/reference/api/2026-07/control-plane/list_index_backups.md): When `include_deleted` is false (or omitted), `index_name` must resolve to an active index in the project. If no active index by that name exists—including the case where only deleted indexes have used the name—the API returns **404**, not an empty list.
- [Describe a backup](https://docs.pinecone.io/reference/api/2026-07/control-plane/describe_backup.md): Get a description of a backup.
- [Delete a backup](https://docs.pinecone.io/reference/api/2026-07/control-plane/delete_backup.md): Delete a backup.
- [Create an index from a backup](https://docs.pinecone.io/reference/api/2026-07/control-plane/create_index_from_backup.md): Create an index from a backup.
- [List restore jobs](https://docs.pinecone.io/reference/api/2026-07/control-plane/list_restore_jobs.md): List all restore jobs for a project.
- [Describe a restore job](https://docs.pinecone.io/reference/api/2026-07/control-plane/describe_restore_job.md): Get a description of a restore job.
- [List collections](https://docs.pinecone.io/reference/api/2026-07/control-plane/list_collections.md): List all collections in a project.
- [Create a collection](https://docs.pinecone.io/reference/api/2026-07/control-plane/create_collection.md): Create a Pinecone collection.
- [Describe a collection](https://docs.pinecone.io/reference/api/2026-07/control-plane/describe_collection.md): Get a description of a collection.
- [Delete a collection](https://docs.pinecone.io/reference/api/2026-07/control-plane/delete_collection.md): Delete an existing collection.

#### Backup schedules

- [Create backup schedule](https://docs.pinecone.io/reference/api/2026-07/control-plane/create_backup_schedule.md): Create a recurring backup schedule for a Pinecone serverless or BYOC index using the API, including daily, weekly, or monthly frequency and retention policy.
- [List backup schedules](https://docs.pinecone.io/reference/api/2026-07/control-plane/list_backup_schedules.md): List all backup schedules configured for a Pinecone serverless index, including schedule IDs, frequency, retention, and next scheduled run times.
- [Describe backup schedule](https://docs.pinecone.io/reference/api/2026-07/control-plane/describe_backup_schedule.md): Retrieve details for a Pinecone backup schedule by schedule ID, including frequency, retention days, next scheduled run, and enabled status.
- [Update backup schedule](https://docs.pinecone.io/reference/api/2026-07/control-plane/update_backup_schedule.md): Update a Pinecone backup schedule using the API, including pausing with enabled, changing frequency, and adjusting the retention expire_after_days.
- [Delete backup schedule](https://docs.pinecone.io/reference/api/2026-07/control-plane/delete_backup_schedule.md): Delete a backup schedule for a Pinecone serverless index using the API by schedule ID, while preserving all previously created backup snapshots.
- [List backup schedule history](https://docs.pinecone.io/reference/api/2026-07/control-plane/list_backup_schedule_history.md): List execution history for a Pinecone backup schedule, including scheduled runs, completed backups, statuses, and cursor-based pagination support.

### Inference

#### Inference

- [Generate vectors](https://docs.pinecone.io/reference/api/2026-07/inference/generate-vectors.md): Generate vector embeddings for input data. This endpoint uses Pinecone's [hosted embedding models](https://docs.pinecone.io/guides/index-data/create-an-index#embedding-models).
- [Rerank results](https://docs.pinecone.io/reference/api/2026-07/inference/rerank-results.md): Rerank results according to their relevance to a query.
- [List available models](https://docs.pinecone.io/reference/api/2026-07/inference/list-available-models.md): List the embedding and reranking models hosted by Pinecone.
- [Describe a model](https://docs.pinecone.io/reference/api/2026-07/inference/describe-a-model.md): Get a description of a model hosted by Pinecone.

### Admin

#### Projects

- [List projects](https://docs.pinecone.io/reference/api/2026-07/admin/projects/list-projects.md): List all projects in an organization.
- [Create a new project](https://docs.pinecone.io/reference/api/2026-07/admin/projects/create-a-new-project.md): Create a new project.
- [Get project details](https://docs.pinecone.io/reference/api/2026-07/admin/projects/get-project-details.md): Get a project's details.
- [Delete a project](https://docs.pinecone.io/reference/api/2026-07/admin/projects/delete-a-project.md): Delete a project and all its configuration; delete its indexes, assistants, backups, and collections first.
- [Update a project](https://docs.pinecone.io/reference/api/2026-07/admin/projects/update-a-project.md): Update a project's name, maximum number of Pods, or customer-managed encryption key (CMEK).

#### Organizations

- [List organizations](https://docs.pinecone.io/reference/api/2026-07/admin/organizations/list-organizations.md): List all organizations associated with an account.
- [Get organization details](https://docs.pinecone.io/reference/api/2026-07/admin/organizations/get-organization-details.md): Get an organization's details.
- [Delete an organization](https://docs.pinecone.io/reference/api/2026-07/admin/organizations/delete-an-organization.md): Delete an organization and all its configuration; delete all its projects first.
- [Update an organization](https://docs.pinecone.io/reference/api/2026-07/admin/organizations/update-an-organization.md): Update an organization's name.

#### API Keys

- [List API keys](https://docs.pinecone.io/reference/api/2026-07/admin/api-keys/list-api-keys.md): List all API keys in a project.
- [Create an API key](https://docs.pinecone.io/reference/api/2026-07/admin/api-keys/create-an-api-key.md): Create an API key for a project to authenticate Data Plane and Control Plane requests.
- [Get API key details](https://docs.pinecone.io/reference/api/2026-07/admin/api-keys/get-api-key-details.md): Get an API key's details, excluding its secret.
- [Delete an API key](https://docs.pinecone.io/reference/api/2026-07/admin/api-keys/delete-an-api-key.md): Delete an API key from a project.
- [Update an API key](https://docs.pinecone.io/reference/api/2026-07/admin/api-keys/update-an-api-key.md): Update an API key's name and roles.

#### Users

- [List users in the organization](https://docs.pinecone.io/reference/api/2026-07/admin/users/list-users-in-the-organization.md): List users in the caller's organization, optionally filtered by email address.
- [Get user details](https://docs.pinecone.io/reference/api/2026-07/admin/users/get-user-details.md): Get a user in the caller's organization by ID.
- [Remove a user from the organization](https://docs.pinecone.io/reference/api/2026-07/admin/users/remove-a-user-from-the-organization.md): Remove a user from the organization and revoke their role bindings; their Pinecone account is not deleted.

#### Invites

- [List invites](https://docs.pinecone.io/reference/api/2026-07/admin/invites/list-invites.md): List pending and expired invites in the caller's organization.
- [Invite a user to the organization](https://docs.pinecone.io/reference/api/2026-07/admin/invites/invite-a-user-to-the-organization.md): Invite a user to the organization by email and grant their initial role bindings.
- [Get invite details](https://docs.pinecone.io/reference/api/2026-07/admin/invites/get-invite-details.md): Get an invite in the caller's organization by ID.
- [Delete an invite](https://docs.pinecone.io/reference/api/2026-07/admin/invites/delete-an-invite.md): Delete a pending or expired invite and its role bindings; to remove an accepted user, delete the user instead.
- [Resend an invite email](https://docs.pinecone.io/reference/api/2026-07/admin/invites/resend-an-invite-email.md): Resend the invite email and extend its expiration to 7 days from now; limited to 100 emails per hour per organization.

#### Service Accounts

- [List service accounts](https://docs.pinecone.io/reference/api/2026-07/admin/service-accounts/list-service-accounts.md): List service accounts in the caller's organization.
- [Create a service account](https://docs.pinecone.io/reference/api/2026-07/admin/service-accounts/create-a-service-account.md): Create a service account with optional initial role bindings; the client secret is returned only once.
- [Get service account details](https://docs.pinecone.io/reference/api/2026-07/admin/service-accounts/get-service-account-details.md): Get a service account by ID; the client secret is returned only from create and rotate-secret requests.
- [Delete a service account](https://docs.pinecone.io/reference/api/2026-07/admin/service-accounts/delete-a-service-account.md): Delete a service account and its role bindings; tokens it minted are revoked within a few seconds.
- [Update a service account](https://docs.pinecone.io/reference/api/2026-07/admin/service-accounts/update-a-service-account.md): Update a service account's name; role bindings are managed through the role-binding endpoints.
- [Rotate a service account's OAuth client secret](https://docs.pinecone.io/reference/api/2026-07/admin/service-accounts/rotate-a-service-accounts-oauth-client-secret.md): Rotate a service account's OAuth client secret; the previous secret and its tokens are revoked within seconds and the new secret is returned only once.

#### Role Bindings

- [List role bindings](https://docs.pinecone.io/reference/api/2026-07/admin/role-bindings/list-role-bindings.md): List role bindings in the caller's organization, optionally filtered by principal, resource, and role.
- [Create a role binding](https://docs.pinecone.io/reference/api/2026-07/admin/role-bindings/create-a-role-binding.md): Grant a role to a principal at an organization or project scope.
- [Get role binding details](https://docs.pinecone.io/reference/api/2026-07/admin/role-bindings/get-role-binding-details.md): Get a role binding in the caller's organization by ID.
- [Delete a role binding](https://docs.pinecone.io/reference/api/2026-07/admin/role-bindings/delete-a-role-binding.md): Delete a role binding; permissions are revoked when the deletion completes.

### SDKs

- [Pinecone SDKs overview](https://docs.pinecone.io/reference/pinecone-sdks.md): Browse official Pinecone SDKs for Python, Node.js, Java, and Go, including the version mappings between SDK releases and API versions.

#### Python

- [Pinecone Python SDK](https://docs.pinecone.io/reference/sdks/python/overview.md): Install and use the Pinecone SDK for Pinecone Python SDK: auth, typed clients, and API operations. For installation instructions, usage examples, and.
- [Reference](https://docs.pinecone.io/reference/sdks/python/reference.md): Reference documentation for the Pinecone Python SDK, including client setup, types, and methods for managing indexes and vector data operations.

#### Node.js

- [Pinecone Node.js SDK](https://docs.pinecone.io/reference/sdks/node/overview.md): Install and use the Pinecone Node.js and TypeScript SDK to manage indexes, upsert vectors, run semantic search, and call the Admin and Inference APIs.
- [Reference](https://docs.pinecone.io/reference/sdks/node/reference.md): Reference documentation for the Pinecone Node.js SDK, including client setup, types, and methods for managing indexes and vector data operations.

#### Java

- [Pinecone Java SDK](https://docs.pinecone.io/reference/sdks/java/overview.md): Install and use the Pinecone Java SDK to manage indexes and namespaces, upsert vectors, run semantic search, and call the Admin and Inference APIs from Java.
- [Reference](https://docs.pinecone.io/reference/sdks/java/reference.md): Reference documentation for the Pinecone Java SDK, including client setup, types, and methods for managing indexes and vector data operations.
- [OpenTelemetry support](https://docs.pinecone.io/reference/sdks/java/open-telemetry.md): Monitor Pinecone Java SDK operations with OpenTelemetry metrics for client latency, server processing time, and errors via Prometheus.

#### Go

- [Pinecone Go SDK](https://docs.pinecone.io/reference/sdks/go/overview.md): Install and use the Pinecone Go SDK to manage indexes and namespaces, upsert vectors, run semantic search, and call the Admin and Inference APIs from Go.
- [Reference](https://docs.pinecone.io/reference/sdks/go/reference.md): Reference documentation for the Pinecone Go SDK, including client setup, types, and methods for managing indexes and vector data operations.

### CLI

- [CLI quickstart](https://docs.pinecone.io/reference/cli/quickstart.md): Pinecone CLI quickstart for installing pc, authenticating, and managing indexes, vectors, and data imports directly from your terminal.
- [CLI command reference](https://docs.pinecone.io/reference/cli/command-reference.md): Complete Pinecone CLI command reference covering syntax, subcommands, flags, help output, and exit codes for auth, index, and project.
- [CLI authentication](https://docs.pinecone.io/reference/cli/authentication.md): Authenticate the Pinecone CLI using user login, service accounts, or API keys, including auth priority and Admin API access rules.
- [CLI target context](https://docs.pinecone.io/reference/cli/target-context.md): Set the Pinecone CLI target context with pc target to control which organization and project your commands run against, including in CI/CD and JSON mode.

### Tools

- [Spark-Pinecone connector](https://docs.pinecone.io/reference/tools/pinecone-spark-connector.md): Pinecone data tools: Use the connector to efficiently create, ingest, and update vector embeddings at scale with Databricks and Pinecone.

## OpenAPI Specs

- [db_control_2026-07.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml)
- [db_data_2026-07.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_data_2026-07.oas.yaml)
- [inference_2026-07.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/inference_2026-07.oas.yaml)
- [admin_2026-07.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/admin_2026-07.oas.yaml)