[metadata]
apple-mobile-web-app-title: Pinecone Docs
application-name: Pinecone Docs
description: Pinecone REST API: Pinecone uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the range.
generator: Mintlify
google-site-verification: woTBImNAcYO-gseVfFKIzQrDRUmLWzFjBWrYbYkOTlI
msapplication-TileColor: #002BFF
msapplication-config: /mintlify-assets/_mintlify/favicons/pinecone/JqxxUxUkDTnX7oN2/_generated/favicon/browserconfig.xml
og:description: Pinecone REST API: Pinecone uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the range.
og:image: https://www.pinecone.io/images/docs_og_image_v2.png
og:image:height: 630
og:image:width: 1200
og:site_name: Pinecone Docs
og:title: Errors - Pinecone Docs
og:type: website
og:url: https://docs.pinecone.io/reference/api/errors
twitter:card: summary_large_image
twitter:description: Search through billions of items for similar matches to any object, in milliseconds. It's the next generation of search, an API call away.
twitter:image: https://www.pinecone.io/images/docs_og_image_v2.png
twitter:image:height: 630
twitter:image:width: 1200
twitter:title: The vector database to build knowledgeable AI | Pinecone
viewport: width=device-width, initial-scale=1, viewport-fit=cover

[canonical-links]
https://docs.pinecone.io/reference/api/errors

[document-links]
/llms.txt: /llms.txt
API key: /guides/projects/understanding-projects#api-keys
Account deactivation for non-payment: /guides/organizations/manage-billing/non-payment-account-deactivation
Authentication: /reference/api/authentication
Authentication: /reference/cli/authentication
Command reference: /reference/cli/command-reference
Error handling: /guides/production/error-handling
Errors: /reference/api/errors
Examples: /examples/notebooks
Guides: /guides/get-started/overview
Implement retry logic with exponential backoff: /guides/production/error-handling#handle-rate-limits-429
Implement retry logic with exponential backoff: /guides/production/error-handling#implement-retry-logic
Integrations: /integrations/overview
Introduction: /reference/api/introduction
Known limitations: /reference/api/known-limitations
List indexes: /reference/api/2026-04/control-plane/list_indexes
Log In: https://app.pinecone.io/?sessionType=login
Models: /models/overview
Pinecone Docs home page: https://www.pinecone.io
Pinecone SDKs overview: /reference/pinecone-sdks
Quickstart: /reference/cli/quickstart
Reference: /reference/api/introduction
Releases: /release-notes/2026
See details: /guides/manage-cost/understanding-cost#imports
Sign up free: https://app.pinecone.io/?sessionType=signup
Spark-Pinecone connector: /reference/tools/pinecone-spark-connector
Status: https://status.pinecone.io
Support: https://app.pinecone.io/organizations/-/settings/support
Target context: /reference/cli/target-context
Troubleshooting: /troubleshooting/contact-support
Versioning: /reference/api/versioning
github: https://github.com/pinecone-io
index deletion protection: /guides/manage-data/manage-indexes#configure-deletion-protection
linkedin: https://www.linkedin.com/company/pinecone-io
quota: /reference/api/database-limits#object-limits
rate-limited: /reference/api/database-limits#rate-limits
x: https://x.com/pinecone?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Eauthor
youtube: https://www.youtube.com/@pinecone-io

[structured-data]
{"@context":"https://schema.org","@graph":[{"@id":"https://docs.pinecone.io/#organization","@type":"Organization","logo":{"@type":"ImageObject","url":"https://mintcdn.com/pinecone/HsZKO51bNmpAasdT/logo/Pinecone-Full-Logo-Black.svg?fit=max&auto=format&n=HsZKO51bNmpAasdT&q=85&s=211d0e7bbefc29ce3b8feee1a05d76ee"},"name":"Pinecone Docs","url":"https://docs.pinecone.io"},{"@id":"https://docs.pinecone.io#website","@type":"WebSite","name":"Pinecone Docs","publisher":{"@id":"https://docs.pinecone.io/#organization"},"url":"https://docs.pinecone.io"},{"@id":"https://docs.pinecone.io/reference/api/errors#webpage","@type":"WebPage","breadcrumb":{"@id":"https://docs.pinecone.io/reference/api/errors#breadcrumb"},"dateModified":"2026-06-03T20:04:32.327Z","description":"Pinecone REST API: Pinecone uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the range.","isPartOf":{"@id":"https://docs.pinecone.io#website"},"name":"Errors","url":"https://docs.pinecone.io/reference/api/errors"},{"@id":"https://docs.pinecone.io/reference/api/errors#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://docs.pinecone.io/reference/api/introduction","name":"APIs","position":1},{"@type":"ListItem","item":"https://docs.pinecone.io/reference/api/errors","name":"Errors","position":2}]},{"@id":"https://docs.pinecone.io/reference/api/errors#article","@type":["Article","TechArticle"],"dateModified":"2026-06-03T20:04:32.327Z","description":"Pinecone REST API: Pinecone uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the range.","headline":"Errors","image":"https://www.pinecone.io/images/docs_og_image_v2.png","isPartOf":{"@id":"https://docs.pinecone.io#website"},"mainEntityOfPage":{"@id":"https://docs.pinecone.io/reference/api/errors#webpage"},"name":"Errors","publisher":{"@id":"https://docs.pinecone.io/#organization"},"url":"https://docs.pinecone.io/reference/api/errors"}]}

[content]
Errors - Pinecone Docs
Documentation Index
Fetch the complete documentation index at:
/llms.txt
Use this file to discover all available pages before exploring further.
Skip to main content
🎉 New: Standard and Enterprise orgs get a one-time
$250 bulk import credit
(1 TB), valid through August 30, 2026.
See details
Pinecone Docs
home page
2026-04 (latest)
Search...
⌘
K
Ask Assistant
Status
Support
Log In
Sign up free
Sign up free
Search...
Navigation
APIs
Errors
Guides
Reference
Examples
Models
Integrations
Troubleshooting
Releases
Pinecone Database
APIs
Introduction
Authentication
Versioning
Limits
Errors
Database
Indexes
Namespaces
Vectors
Search
Imports
Backups
Backup schedules
Inference
Embed
Rerank
Models
Admin
API keys
Projects
Service accounts
Users
Invites
Role bindings
SDKs
Pinecone SDKs overview
Python
Node.js
Java
Go
CLI
Quickstart
Command reference
Authentication
Target context
Tools
Spark-Pinecone connector
On this page
200 - OK
201 - CREATED
202 - NO CONTENT
400 - INVALID ARGUMENT
401 - UNAUTHENTICATED
402 - PAYMENT REQUIRED
403 - FORBIDDEN
404 - NOT FOUND
409 - ALREADY EXISTS
412 - FAILED PRECONDITIONS
422 - UNPROCESSABLE ENTITY
429 - TOO MANY REQUESTS
500 - UNKNOWN
502 - BAD GATEWAY
503 - UNAVAILABLE
504 - GATEWAY TIMEOUT
APIs
Errors
Copy page
Copy page
Pinecone REST API: Pinecone uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the range.
Copy page
Copy page
Pinecone uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the
2xx
range indicate success, codes in the
4xx
range indicate an error that failed given the information provided, and codes in the
5xx
range indicate an error with Pinecone’s servers.
For guidance on handling errors in production, see
Error handling
.
​
200 - OK
The request succeeded.
​
201 - CREATED
The request succeeded and a new resource was created.
​
202 - NO CONTENT
The request succeeded, but there is no content to return.
​
400 - INVALID ARGUMENT
The request failed due to an invalid argument.
​
401 - UNAUTHENTICATED
The request failed due to a missing or invalid
API key
.
​
402 - PAYMENT REQUIRED
The request failed due to delinquent payment or account deactivation for non-payment. See
Account deactivation for non-payment
.
​
403 - FORBIDDEN
The request failed due to an exceeded
quota
or
index deletion protection
.
​
404 - NOT FOUND
The request failed because the resource was not found.
​
409 - ALREADY EXISTS
The request failed because the resource already exists.
​
412 - FAILED PRECONDITIONS
The request failed due to preconditions not being met. |
​
422 - UNPROCESSABLE ENTITY
The request failed because the server was unable to process the contained instructions.
​
429 - TOO MANY REQUESTS
The request was
rate-limited
.
Implement retry logic with exponential backoff
to handle this error.
​
500 - UNKNOWN
An internal server error occurred.
Implement retry logic with exponential backoff
to handle transient errors.
​
502 - BAD GATEWAY
The API gateway received an invalid response from a backend service. This is typically a temporary error.
Implement retry logic with exponential backoff
to handle transient errors.
​
503 - UNAVAILABLE
The server is currently unavailable.
Implement retry logic with exponential backoff
to handle transient errors.
​
504 - GATEWAY TIMEOUT
The API gateway did not receive a timely response from the backend server. This can occur due to slow requests or backend processing delays.
Implement retry logic with exponential backoff
to handle transient errors.
Was this page helpful?
Yes
No
Known limitations
List indexes
⌘
I
x
linkedin
youtube
github
Assistant
Responses are generated using AI and may contain mistakes.
