Delete records
Delete records by id or by metadata from a single namespace.
For guidance and examples, see Delete data.
# To get the unique host for an index,
# see https://docs.pinecone.io/guides/manage-data/target-an-index
PINECONE_API_KEY="YOUR_API_KEY"
INDEX_HOST="INDEX_HOST"
curl "https://$INDEX_HOST/vectors/delete" \
-H "Api-Key: $PINECONE_API_KEY" \
-H "Content-Type: application/json" \
-H "X-Pinecone-Api-Version: 2026-07" \
-d '{
"ids": [
"id-1",
"id-2"
],
"namespace": "example-namespace"
}
'POST /vectors/delete
{}{
"code": 123,
"message": "<string>",
"details": [
{
"typeUrl": "<string>",
"value": "<string>"
}
]
}{
"code": 123,
"message": "<string>",
"details": [
{
"typeUrl": "<string>",
"value": "<string>"
}
]
}{
"code": 123,
"message": "<string>",
"details": [
{
"typeUrl": "<string>",
"value": "<string>"
}
]
}Authorizations
Section titled “Authorizations”Api-KeystringrequiredAn API Key is required to call Pinecone APIs. Get yours from the console.
Headers
Section titled “Headers”X-Pinecone-Api-VersionstringrequiredRequired date-based version header
ids?string[]Vectors to delete.
deleteAll?booleanThis indicates that all vectors in the index namespace should be deleted. Cannot be combined with ids.
Example: false
namespace?stringThe namespace to delete records from, if applicable.
Example: example-namespace
filter?objectIf specified, the metadata filter here will be used to select the vectors to delete. This is mutually exclusive with using delete_all=True. See Delete data.
Response
Section titled “Response”200 — A successful response.
response?objectThe response for the delete operation.