Skip to main content
Pinecone Docs

Search documentation

Type to search this documentation.

On this pageOverview

Delete a backup

curl
PINECONE_API_KEY="YOUR_API_KEY"
BACKUP_ID="9947520e-d5a1-4418-a78d-9f464c9969da"

curl -X DELETE "https://api.pinecone.io/backups/$BACKUP_ID" \
    -H "Api-Key: $PINECONE_API_KEY" \
    -H "X-Pinecone-Api-Version: 2026-07"

DELETE /backups/{backup_id}

cURL
curl --request DELETE \
  --url https://api.pinecone.io/backups/{backup_id} \
  --header 'Authorization: Bearer <token>'
403
{
  "error": {
    "code": "INVALID_ARGUMENT",
    "message": "Index name must contain only lowercase alphanumeric characters or hyphens, and must not begin or end with a hyphen."
  },
  "status": 400
}
  • Authorization (header, string, required) — Bearer authentication header of the form Bearer <token>.
  • backup_id (path, string, required) — The ID of the backup to delete.
  • X-Pinecone-Api-Version (header, string, required) — Required date-based version header
  • 202 — The request to delete the backup has been accepted.
  • 401 — Unauthorized. Possible causes: missing or invalid API key.
  • 403 — Forbidden. The API key or principal is authenticated but lacks the permission required for this operation. Grant the required permission to the key's role, or use a key that already holds it.
  • 404 — Backup not found.
  • 500 — Internal server error.
Suggest an edit

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

Export
Documentation menu