This page describes how to create a static copy of a serverless index, also known as a backup.

Serverless index backups are in public preview and available only on Standard and Enterprise plans.

Create a backup

You can create a backup from a serverless index, as in the following example:

curl
PINECONE_API_KEY="YOUR_API_KEY"
INDEX_NAME="example-index"

curl "https://api.pinecone.io/indexes/$INDEX_NAME/backups" \
    -H "Api-Key: $PINECONE_API_KEY" \
    -H 'accept: application/json' \
    -H 'Content-Type: application/json' \
    -H "X-Pinecone-API-Version: 2025-04" \
    -d '{
      "name": "example-backup", 
      "description": "Monthly backup of production index"
      }'

The example returns a response like the following:

{
  "backup_id":"9947520e-d5a1-4418-a78d-9f464c9969da",
  "source_index_id":"8433941a-dae7-43b5-ac2c-d3dab4a56b2b",
  "source_index_name":"example-index",
  "tags":{},
  "name":"example-backup",
  "description":"Monthly backup of production index",
  "status":"Pending",
  "cloud":"aws",
  "region":"us-east-1",
  "dimension":null,
  "record_count":null,
  "namespace_count":null,
  "size_bytes":null,
  "created_at":"2025-03-11T18:29:50.549482312Z"
  }

You can create a backup using the Pinecone console.

View all backups for an index

You can view all backups for an index, as in the following example:

curl
PINECONE_API_KEY="YOUR_API_KEY"
INDEX_NAME="example-index"

curl -X GET "https://api.pinecone.io/indexes/$INDEX_NAME/backups" \
    -H "Api-Key: $PINECONE_API_KEY" \
    -H "X-Pinecone-API-Version: 2025-04" \
    -H "accept: application/json"

The example returns a response like the following:

{
  "data":
  [
    {
      "backup_id":"9947520e-d5a1-4418-a78d-9f464c9969da",
      "source_index_id":"8433941a-dae7-43b5-ac2c-d3dab4a56b2b",
      "source_index_name":"example-index",
      "tags":{},
      "name":"example-backup",
      "description":"Monthly backup of production index",
      "status":"Pending",
      "cloud":"aws",
      "region":"us-east-1",
      "dimension":null,
      "record_count":null,
      "namespace_count":null,
      "size_bytes":null,
      "created_at":"2025-03-11T18:29:50.549505Z"
      }
    ],
  "pagination":null
}

You can view the backups for a specific index from either the Backups tab or the Indexes tab in the Pinecone console.

View all backups in a project

You can view backups for all indexes in a project, as in the following example:

curl
PINECONE_API_KEY="YOUR_API_KEY"

curl -X GET "https://api.pinecone.io/backups" \
    -H "Api-Key: $PINECONE_API_KEY" \
    -H "X-Pinecone-API-Version: 2025-04" \
    -H "accept: application/json"

The example returns a response like the following:

{
  "data":
  [
    {
      "backup_id":"9947520e-d5a1-4418-a78d-9f464c9969da",
      "source_index_id":"8433941a-dae7-43b5-ac2c-d3dab4a56b2b",
      "source_index_name":"example-index-3",
      "tags":{},
      "name":"example-backup",
      "description":"Monthly backup of production index",
      "status":"Pending",
      "cloud":"aws",
      "region":"us-east-1",
      "dimension":null,
      "record_count":null,
      "namespace_count":null,
      "size_bytes":null,
      "created_at":"2025-03-11T18:29:50.549505Z"
    },
    {
      "backup_id":"a65ff585-d987-4da5-a622-72e19a6ed5f4",
      "source_index_id":"1d724c1f-7a1f-469f-8514-4da2bc6e8b09",
      "source_index_name":"example-index",
      "tags":null,
      "name":"example-backup-2",
      "description":null,
      "status":"Completed",
      "cloud":"aws",
      "region":"us-east-1",
      "dimension":1024,
      "record_count":350690,
      "namespace_count":null,
      "size_bytes":2038652848,
      "created_at":"2025-03-07T17:21:06.333375Z"
    },
    {
      "backup_id":"b2703bbe-e348-4309-88db-dbf005d7c1bb",
      "source_index_id":"1d724c1f-7a1f-469f-8514-4da2bc6e8b09",
      "source_index_name":"example-index",
      "tags":null,
      "name":"example-backup",
      "description":null,
      "status":"Completed",
      "cloud":"aws",
      "region":"us-east-1",
      "dimension":1024,
      "record_count":350690,
      "namespace_count":null,
      "size_bytes":2038652848,
      "created_at":"2025-03-07T17:00:41.583538Z"
    }
  ],
  "pagination":null
}

You can view all backups in a project using the Pinecone console.

View backup details

You can view the details of a backup, as in the following example:

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

curl -X GET "https://api.pinecone.io/backups/$BACKUP_ID" \
    -H "Api-Key: $PINECONE_API_KEY" \
    -H "X-Pinecone-API-Version: 2025-04" \
    -H "accept: application/json"

The example returns a response like the following:

{
  "backup_id":"9947520e-d5a1-4418-a78d-9f464c9969da",
  "source_index_id":"8433941a-dae7-43b5-ac2c-d3dab4a56b2b",
  "source_index_name":"example-index",
  "tags":{},
  "name":"example-backup",
  "description":"Monthly backup of production index",
  "status":"Pending",
  "cloud":"aws",
  "region":"us-east-1",
  "dimension":null,
  "record_count":null,
  "namespace_count":null,
  "size_bytes":null,
  "created_at":"2025-03-11T18:29:50.549505Z"
}

You can view backup details using the Pinecone console.

Delete a backup

You can delete a backup, as in the following example:

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: 2025-04"

You can delete a backup using the Pinecone console.