Skip to main content
Pinecone Docs
current

Search documentation

Type to search this documentation.

Delete an index

Delete an existing index.

curl
PINECONE_API_KEY="YOUR_API_KEY"

curl -i -X DELETE "https://api.pinecone.io/indexes/docs-example" \
  -H "Api-Key: $PINECONE_API_KEY" \
  -H "X-Pinecone-Api-Version: 2026-07"

DELETE /indexes/{index_name}

403
{
  "error": {
    "code": "FORBIDDEN",
    "message": "Deletion protection is enabled for this index. Disable deletion protection before retrying."
  },
  "status": 403
}
404
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Index example-index not found."
  },
  "status": 404
}
412
{
  "error": {
    "code": "FAILED_PRECONDITION",
    "message": "Unable to delete an index. There are pending collections for this index: ['test-collection']"
  },
  "status": 412
}
500
{
  "error": {
    "code": "UNKNOWN",
    "message": "Internal server error"
  },
  "status": 500
}
Api-Keystringrequired

An API Key is required to call Pinecone APIs. Get yours from the console.

X-Pinecone-Api-Versionstringrequired

Required date-based version header

Typestring
Default2026-07
index_namestringrequired

The name of the index to delete.

Typestring

202 — The request to delete the index has been accepted.

Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu