Rate limits help protect your applications from misuse and maintain the health of our shared serverless infrastructure. These limits are designed to support typical production workloads while ensuring reliable performance for all users.Most rate limits can be adjusted upon request. If you need higher limits to scale your application, contact Support with details about your use case. Pinecone is committed to supporting your growth and can often accommodate higher throughput requirements.Rate limits vary based on pricing plan and apply to serverless indexes only.
Indexes built on Dedicated Read Nodes are not subject to read unit limits for query, fetch, and list operations. For sizing and capacity planning guidance, see the Dedicated Read Nodes guide.
Pinecone enforces rate limits on the number of API requests per second at the namespace level for data plane operations (query, upsert, delete, and update). These limits provide protection against excessive request rates.
When you exceed the request-per-second limit, you’ll receive an HTTP 429 - TOO_MANY_REQUESTS response. The error message indicates which operation exceeded the limit and includes the namespace name and limit value. See the individual limit sections below for specific error message formats.
Read units measure the compute, I/O, and network resources used by fetch, query, and list requests to serverless indexes. When you reach the monthly read unit limit for an organization, fetch, query, and list requests to serverless indexes in the organization will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached your read unit limit for the current month limit. To continue reading data, upgrade your plan.
To continue reading from serverless indexes in the organization, upgrade your plan.To check how close you are to the monthly read unit limit for your organization, do the following:
Indexes built on Dedicated Read Nodes are not subject to read unit limits for query, fetch, and list operations. For sizing and capacity planning guidance, see the Dedicated Read Nodes guide.
Write units measure the storage and compute resources used by upsert, update, and delete requests to serverless indexes. When you reach the monthly write unit limit for an organization, upsert, update, and delete requests to serverless indexes in the organization will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached your write unit limit for the current month. To continue writing data, upgrade your plan.
To continue writing data to serverless indexes in the organization, upgrade your plan.To check how close you are to the monthly write unit limit for your organization, do the following:
When you reach the per second upsert size for a namespace in an index, additional upserts will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the max upsert size limit per second for index <index name>. Pace your upserts or contact Pinecone Support (https://app.pinecone.io/organizations/-/settings/support/ticket) to request a higher limit.
Pinecone measures query usage in read units. When you reach the per second limit for queries across all namespaces in an index, additional queries will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the max query read units per second for index <index name>. Pace your queries or contact Pinecone Support (https://app.pinecone.io/organizations/-/settings/support/ticket) to request a higher limit.
Indexes built on Dedicated Read Nodes are not subject to read unit limits for query, fetch, and list operations. For sizing and capacity planning guidance, see the Dedicated Read Nodes guide.
When you reach the per second query limit for a namespace in an index, additional queries will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the query QPS limit for namespace {namespace_name} ({limit} QPS). Pace your queries,consider Dedicated Read Nodes for your index, or contact Pinecone Support(https://app.pinecone.io/organizations/-/settings/support/ticket) to request a higher limit.
Indexes built on Dedicated Read Nodes are not subject to read unit limits for query, fetch, and list operations. For sizing and capacity planning guidance, see the Dedicated Read Nodes guide.
When you reach the per second update limit for a namespace in an index, additional updates will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the max update records per second for namespace <namespace name>. Pace your update requests or contact Pinecone Support (https://app.pinecone.io/organizations/-/settings/support/ticket) to request a higher limit.
When you reach the per second update request limit for a namespace in an index, additional update requests will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the update QPS limit for namespace {namespace_name} ({limit} QPS). Pace your update requests or contact Pinecone Support (https://app.pinecone.io/organizations/-/settings/support/ticket) to request a higher limit.
If you need to update most of the records in a large namespace, contact Support for help creating an export to enable a faster and more cost-effective approach.
Update by metadata requests per second per namespace
Starter plan
Builder plan
Standard plan
Enterprise plan
5
5
5
5
When you reach the per second update by metadata request limit for a namespace in an index, additional update by metadata requests will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the max update by metadata requests per second for namespace <namespace name>. Pace your update by metadata requests or contact Pinecone Support (https://app.pinecone.io/organizations/-/settings/support/ticket) to request a higher limit.
When you reach the per second update by metadata request limit across all namespaces in an index, additional update by metadata requests will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the max update by metadata requests per second for index <index name>. Pace your update by metadata requests or contact Pinecone Support (https://app.pinecone.io/organizations/-/settings/support/ticket) to request a higher limit.
When you reach the per second upsert request limit for a namespace in an index, additional upsert requests will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the upsert QPS limit for namespace {namespace_name} ({limit} QPS). Pace your upsert requests or contact Pinecone Support (https://app.pinecone.io/organizations/-/settings/support/ticket) to request a higher limit.
When you reach the per second fetch limit across all namespaces in an index, additional fetch requests will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the max fetch requests per second for index <index name>.Pace your fetch requests or contact Pinecone Support (https://app.pinecone.io/organizations/-/settings/support/ticket) to request a higher limit.
Indexes built on Dedicated Read Nodes are not subject to read unit limits for query, fetch, and list operations. For sizing and capacity planning guidance, see the Dedicated Read Nodes guide.
When you reach the per second list limit across all namespaces in an index, additional list requests will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the max list requests per second for index <index name>.Pace your list requests or contact Pinecone Support (https://app.pinecone.io/organizations/-/settings/support/ticket) to request a higher limit.
Indexes built on Dedicated Read Nodes are not subject to read unit limits for query, fetch, and list operations. For sizing and capacity planning guidance, see the Dedicated Read Nodes guide.
Describe index stats requests per second per index
Starter plan
Builder plan
Standard plan
Enterprise plan
100
100
100
100
When you reach the per second describe index stats limit across all namespaces in an index, additional describe index stats requests will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the max describe_index_stats requests per second for index <index>. Pace your describe_index_stats requests or contact Pinecone Support (https://app.pinecone.io/organizations/-/settings/support/ticket) to request a higher limit.
When you reach the per second delete request limit for a namespace in an index, additional delete requests will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the delete QPS limit for namespace {namespace_name} ({limit} QPS). Pace your delete requests or contact Pinecone Support (https://app.pinecone.io/organizations/-/settings/support/ticket) to request a higher limit.
When you reach the per second delete limit for a namespace in an index, additional deletes will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the max delete records per second for namespace <namespace name>. Pace your delete requests or contact Pinecone Support (https://app.pinecone.io/organizations/-/settings/support/ticket) to request a higher limit.
When you reach the per second delete limit across all namespaces in an index, additional deletes will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the max delete records per second for index <index name>. Pace your delete requests or contact Pinecone Support (https://app.pinecone.io/organizations/-/settings/support/ticket) to request a higher limit.
Delete by metadata requests per second per namespace
Starter plan
Builder plan
Standard plan
Enterprise plan
5
5
5
5
When you reach the per second delete by metadata request limit for a namespace in an index, additional delete by metadata requests will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the max delete by metadata requests per second for namespace <namespace name>. Pace your delete by metadata requests or contact Pinecone Support (https://app.pinecone.io/organizations/-/settings/support/ticket) to request a higher limit.
When you reach the per second delete by metadata request limit across all namespaces in an index, additional delete by metadata requests will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the max delete by metadata requests per second for index <index name>. Pace your delete by metadata requests or contact Pinecone Support (https://app.pinecone.io/organizations/-/settings/support/ticket) to request a higher limit.
When you reach the per minute token limit for an embedding model hosted by Pinecone, additional embeddings will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the max embedding tokens per minute (<limit>) model '<model name>'' and input type '<passage|query>' for the current project. To increase this limit, upgrade your plan.
When you reach the monthly token limit for an embedding model hosted by Pinecone, additional embeddings will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the embedding token limit (<limit>) for model <model name> for the current month. To continue using this model, upgrade your plan.
When you reach the per minute request limit for a reranking model hosted by Pinecone, additional reranking requests will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the max rerank requests per minute (<limit>) for model '<model name>' for the current project. To increase this limit, upgrade your plan.
When you reach the monthly request limit for a reranking model hosted by Pinecone, additional reranking requests will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the rerank request limit (<limit>) for model <model name> for the current month. To continue using this model, upgrade your plan.
Inference requests per second or minute, per project
Metric
Starter plan
Builder plan
Standard plan
Enterprise plan
Inference requests per second
100
100
100
100
Inference requests per minute
2000
2000
2000
2000
When you reach the per second or per minute request limit, inference requests will fail and return a 429 - TOO_MANY_REQUESTS status with the following error:
Error response
Request failed. You've reached the max inference requests per second (<limit>) for the current project.
This error indicates per second or per minute, as applicable.
1 On the Starter plan, all serverless indexes must be in the us-east-1 region of AWS. Builder, Standard, and Enterprise plans can create indexes in any supported region.
When you reach this quota for a project, trying to create serverless indexes in the project will fail and return a 403 - QUOTA_EXCEEDED status with the following error:
Error response
Request failed. You've reached the max serverless indexes allowed in project <project>. Use namespaces to partition your data into logical groups, or upgrade your plan to add more serverless indexes.
To stay under this quota, consider using namespaces instead of creating multiple indexes. Namespaces let you partition your data into logical groups within a single index. This approach not only helps you stay within index limits, but can also improve query performance and lower costs by limiting searches to relevant data subsets.To increase this quota, upgrade your plan.
This limit applies to organizations on the Starter and Builder plans only.
Starter plan
Builder plan
Standard plan
Enterprise plan
2 GB
10 GB
N/A
N/A
When you’ve reached this quota for an organization, updates and upserts into serverless indexes will fail and return a 403 - QUOTA_EXCEEDED status with the following error:
Error response
Request failed. You've reached the max storage allowed for organization <org name>. To update or upsert new data, delete records or upgrade your plan.
To continue writing data into your serverless indexes, delete records to bring your organization under the limit or upgrade your plan.
When you reach this quota for a serverless index, trying to upsert records into a new namespace in the index will fail and return a 403 - QUOTA_EXCEEDED status with the following error:
Error response
Request failed. You've reached the max namespaces allowed in serverless index <index name>. To add more namespaces, upgrade your plan.
Namespaces per serverless index vary by plan. On the Standard and Enterprise plans, Pinecone can accommodate million-scale namespaces and beyond for specific use cases. If your application requires more than 100,000 namespaces, contact Support.
Backups are not available on the Starter or Builder plans. On the Standard and Enterprise plans, when you reach this quota for a project, trying to create serverless backups in the project will fail and return a 403 - QUOTA_EXCEEDED status with the following error:
Error response
Backup failed to create. Quota for number of backups per index exceeded.
When you reach this quota for a project, trying to create collections in the project will fail and return a 403 - QUOTA_EXCEEDED status with the following error:
Error response
Request failed. You've reached the max collections allowed in project <project name>. To add more collections, upgrade your plan.
Operation limits are restrictions on the size, number, or other characteristics of operations in Pinecone. Operation limits are fixed and do not vary based on pricing plan.
If your import exceeds these limits, you’ll get an error specifying the limit exceeded. See Troubleshooting for details.
Metric
Limit
Max namespaces per import
10,000
Max total input data size (on-demand indexes)
1 TB
Max total input data size (DRN indexes)
Unlimited
Max files per import
100,000
Max size per file
10 GB
The total input data size limit does not apply to indexes with dedicated read nodes.Bulk import supports indexes without a schema definition (Parquet files) and indexes with document schemas (JSONL files). Semantic-text (auto-embedded) fields are not yet supported in document schemas.
The query result size is affected by the dimension of the dense vectors and whether or not dense vector values and metadata are included in the result.
If a query fails due to exceeding the 4MB result size limit, choose a lower top_k value, or use include_metadata=False or include_values=False to exclude metadata or values from the result. For better performance, especially with higher top_k values, avoid including vector values unless you need them.
The following limits apply to metadata filter expressions used in query, delete, update, and fetch operations.
Limit
Value
Description
Maximum values per $in or $nin operator
10,000
Each $in or $nin operator accepts up to 10,000 values in its array. This limit applies per operator—if you have multiple $in operators in a single filter, each is independently limited to 10,000 values.
When you exceed this limit, the request will fail and return a 400 - BAD_REQUEST error.
Large $in operators can impact query performance and cost. Filters with thousands of values increase request payload size and end-to-end latency. Additionally, using large filters typically indicates a shared namespace architecture, which increases query costs—queries scan the entire namespace regardless of filters.
If you need to filter by more than 10,000 values, consider these alternatives:
Use namespaces for tenant isolation: Instead of filtering by tenant IDs within a single namespace, create separate namespaces for each tenant or tenant group. This can also reduce query costs. See Design for multi-tenancy.
Use broader access control groups: Instead of filtering by individual user IDs, filter by organization, project, or role. This reduces the number of values in your $in filter. See Design for multi-tenancy.
Post-filter client-side: Retrieve a larger top K without filtering (for example, top 1000), then filter results client-side.
Run multiple queries: Split your filter into multiple queries with smaller $in operators and combine the results client-side.
To avoid hitting this limit in production, validate the size of your $in and $nin arrays in your application code before making the request to Pinecone.