# Pinecone Docs: Pinecone Database Reference 2026-04

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

## 2026-04

### 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-04/control-plane/list_indexes.md): List all indexes in a project.
- [Create an index](https://docs.pinecone.io/reference/api/2026-04/control-plane/create_index.md): Create a Pinecone index. This is where you specify the measure of similarity, the dimension of vectors to be stored in the index, which cloud provider you would like to deploy with, and more. To restore from a backup, set `spec.serverless.source_backup_id` and specify the target `cloud` and `region`…
- [Create an index with integrated embedding](https://docs.pinecone.io/reference/api/2026-04/control-plane/create_for_model.md): Create an index with integrated embedding. With this type of index, you provide source text, and  Pinecone uses a [hosted embedding model](https://docs.pinecone.io/guides/index-data/create-an-index#embedding-models)  to convert the text automatically during [upsert](https://docs.pinecone.io/referenc…
- [Describe an index](https://docs.pinecone.io/reference/api/2026-04/control-plane/describe_index.md): Get a description of an index.
- [Delete an index](https://docs.pinecone.io/reference/api/2026-04/control-plane/delete_index.md): Delete an existing index.
- [Configure an index](https://docs.pinecone.io/reference/api/2026-04/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-04/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-04/data-plane/listnamespaces.md): List all namespaces in a serverless index.
- [Create a namespace](https://docs.pinecone.io/reference/api/2026-04/data-plane/createnamespace.md): Create a namespace in a serverless index.
- [Describe a namespace](https://docs.pinecone.io/reference/api/2026-04/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-04/data-plane/deletenamespace.md): Delete a namespace from a serverless index. Deleting a namespace is irreversible; all data in the namespace is permanently deleted.

#### Vectors

- [Upsert records](https://docs.pinecone.io/reference/api/2026-04/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-04/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-04/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-04/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-04/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-04/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-04/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-04/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-04/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.

#### Imports

- [Start import](https://docs.pinecone.io/reference/api/2026-04/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-04/data-plane/list_imports.md): List all recent and ongoing import operations.
- [Describe an import](https://docs.pinecone.io/reference/api/2026-04/data-plane/describe_import.md): Return details of a specific import operation.
- [Cancel an import](https://docs.pinecone.io/reference/api/2026-04/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-04/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-04/control-plane/list_project_backups.md): List all backups for a project.
- [List backups for an index](https://docs.pinecone.io/reference/api/2026-04/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. When `include_deleted` is true, the API retur…
- [Describe a backup](https://docs.pinecone.io/reference/api/2026-04/control-plane/describe_backup.md): Get a description of a backup.
- [Delete a backup](https://docs.pinecone.io/reference/api/2026-04/control-plane/delete_backup.md): Delete a backup.
- [Create an index from a backup](https://docs.pinecone.io/reference/api/2026-04/control-plane/create_index_from_backup.md): Create an index from a backup. For serverless backups, you can optionally set `read_capacity` so the restored index is created with dedicated read nodes (DRN) instead of defaulting to on-demand capacity.
- [List restore jobs](https://docs.pinecone.io/reference/api/2026-04/control-plane/list_restore_jobs.md): List all restore jobs for a project.
- [Describe a restore job](https://docs.pinecone.io/reference/api/2026-04/control-plane/describe_restore_job.md): Get a description of a restore job.
- [List collections](https://docs.pinecone.io/reference/api/2026-04/control-plane/list_collections.md): List all collections in a project. Serverless indexes do not support collections.
- [Create a collection](https://docs.pinecone.io/reference/api/2026-04/control-plane/create_collection.md): Create a Pinecone collection.    Serverless indexes do not support collections.
- [Describe a collection](https://docs.pinecone.io/reference/api/2026-04/control-plane/describe_collection.md): Get a description of a collection. Serverless indexes do not support collections.
- [Delete a collection](https://docs.pinecone.io/reference/api/2026-04/control-plane/delete_collection.md): Delete an existing collection. Serverless indexes do not support collections.

#### Backup schedules

- [Create backup schedule](https://docs.pinecone.io/reference/api/2026-04/control-plane/create_backup_schedule.md): Create a recurring backup schedule for a Pinecone serverless index using the API, including daily, weekly, or monthly frequency and retention policy.
- [List backup schedules](https://docs.pinecone.io/reference/api/2026-04/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-04/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-04/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-04/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-04/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

#### Embed

- [Generate vectors](https://docs.pinecone.io/reference/api/2026-04/inference/generate-embeddings.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

- [Rerank results](https://docs.pinecone.io/reference/api/2026-04/inference/rerank.md): Rerank results according to their relevance to a query.

#### Models

- [List available models](https://docs.pinecone.io/reference/api/2026-04/inference/list_models.md): List the embedding and reranking models hosted by Pinecone.
- [Describe a model](https://docs.pinecone.io/reference/api/2026-04/inference/describe_model.md): Get a description of a model hosted by Pinecone.

### Admin

#### API keys

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

#### Projects

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

#### Service accounts

- [Create a service account](https://docs.pinecone.io/reference/api/2026-04/admin/create_service_account.md): Create a service account with optional initial role bindings; the client secret is returned only once.
- [List service accounts](https://docs.pinecone.io/reference/api/2026-04/admin/list_service_accounts.md): List service accounts in the caller's organization.
- [Get service account details](https://docs.pinecone.io/reference/api/2026-04/admin/fetch_service_account.md): Get a service account by ID; the client secret is returned only from create and rotate-secret requests.
- [Update a service account](https://docs.pinecone.io/reference/api/2026-04/admin/update_service_account.md): Update a service account's name; role bindings are managed through the role-binding endpoints.
- [Delete a service account](https://docs.pinecone.io/reference/api/2026-04/admin/delete_service_account.md): Delete a service account and its role bindings; tokens it minted are revoked within a few seconds.
- [Rotate a service account's OAuth client secret](https://docs.pinecone.io/reference/api/2026-04/admin/rotate_service_account_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.
- [Create an access token](https://docs.pinecone.io/reference/api/2026-04/admin/get_token.md): Obtain an access token for a service account using the OAuth2 client credentials flow. An access token is needed to authorize requests to the Pinecone Admin API. The host domain for OAuth endpoints is `login.pinecone.io`.

#### Users

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

#### Invites

- [Invite a user to the organization](https://docs.pinecone.io/reference/api/2026-04/admin/create_invite.md): Invite a user to the organization by email and grant their initial role bindings.
- [List invites](https://docs.pinecone.io/reference/api/2026-04/admin/list_invites.md): List pending and expired invites in the caller's organization.
- [Get invite details](https://docs.pinecone.io/reference/api/2026-04/admin/fetch_invite.md): Get an invite in the caller's organization by ID.
- [Delete an invite](https://docs.pinecone.io/reference/api/2026-04/admin/delete_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-04/admin/resend_invite.md): Resend the invite email and extend its expiration to 7 days from now; limited to 100 emails per hour per organization.

#### Role bindings

- [Create a role binding](https://docs.pinecone.io/reference/api/2026-04/admin/create_role_binding.md): Grant a role to a principal at an organization or project scope.
- [List role bindings](https://docs.pinecone.io/reference/api/2026-04/admin/list_role_bindings.md): List role bindings in the caller's organization, optionally filtered by principal, resource, and role.
- [Get role binding details](https://docs.pinecone.io/reference/api/2026-04/admin/fetch_role_binding.md): Get a role binding in the caller's organization by ID.
- [Delete a role binding](https://docs.pinecone.io/reference/api/2026-04/admin/delete_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-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/db_control_2026-04.oas.yaml)
- [db_data_2026-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/db_data_2026-04.oas.yaml)
- [inference_2026-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/inference_2026-04.oas.yaml)
- [admin_2026-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/admin_2026-04.oas.yaml)
- [oauth_2026-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/oauth_2026-04.oas.yaml)