Delete a namespace alias
Remove an alias. The target namespace and its data are unchanged. Reads
that still use the alias name are treated as reads of a nonexistent namespace (empty results, not an error), so migrate readers off the alias first.
The call returns once no reader still resolves the alias, which takes about a second; size client timeouts accordingly. A retried delete that returns 404 means the alias is already gone and carries the same guarantee.
For guidance and examples, see Manage namespace aliases.
# 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"
ALIAS_NAME="dataset"
curl -X DELETE "https://$INDEX_HOST/namespace-aliases/$ALIAS_NAME" \
-H "Api-Key: $PINECONE_API_KEY" \
-H "X-Pinecone-Api-Version: 2026-07"DELETE /namespace-aliases/{alias_name}
{}{
"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>"
}
]
}{
"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
Path Parameters
Section titled “Path Parameters”alias_namestringrequiredThe name of the alias. Must be 1-512 characters of printable ASCII, excluding space and / ? # % & = \ ; +.
Required string length: 1 - 512
Response
Section titled “Response”200 — A successful response.
response?objectThe response for the delete operation.