Restore an index - Pinecone Docs

Create a serverless index from a backup

When restoring a serverless index from backup, you can change the index name, tags, and deletion protection setting. All other properties of the restored index will remain identical to the source index, including cloud and region, dimension and similarity metric, and associated embedding model when restoring an index with integrated embedding. To create a serverless index from a backup, provide the ID of the backup, the name of the new index, and, optionally, changes to the index tags and deletion protection settings:

from pinecone import Pinecone

pc = Pinecone(api_key="YOUR_API_KEY")

pc.create_index_from_backup(
    backup_id="a65ff585-d987-4da5-a622-72e19a6ed5f4",
    name="restored-index",
    tags={
        "tag0": "val0", 
        "tag1": "val1"
    },
    deletion_protection="enabled"
)

import { Pinecone } from '@pinecone-database/pinecone';

const pc = new Pinecone({ apiKey: 'YOUR_API_KEY' })

const response = await pc.createIndexFromBackup({
  backupId: 'a65ff585-d987-4da5-a622-72e19a6ed5f4',
  name: 'restored-index',
  tags: {
    tag0: 'val0',
    tag1: 'val1'
  },
  deletionProtection: 'enabled'
});

console.log(response);

import io.pinecone.clients.Pinecone;
import org.openapitools.db_control.client.ApiException;
import org.openapitools.db_control.client.model.*;

public class CreateIndexFromBackup {
    public static void main(String[] args) throws ApiException {
        Pinecone pc = new Pinecone.Builder("YOUR_API_KEY").build();

        String backupID = "a65ff585-d987-4da5-a622-72e19a6ed5f4";
        String indexName = "restored-index";

        CreateIndexFromBackupResponse backupResponse = pc.createIndexFromBackup(backupID, indexName);
        System.out.println(backupResponse);
    }
}

package main

import (
	"context"
	"encoding/json"
	"fmt"
	"log"
	"time"

	"github.com/pinecone-io/go-pinecone/v4/pinecone"
)

func prettifyStruct(obj interface{}) string {
	bytes, _ := json.MarshalIndent(obj, "", "  ")
	return string(bytes)
}

func main() {
	ctx := context.Background()

	pc, err := pinecone.NewClient(pinecone.NewClientParams{
		ApiKey: "YOUR_API_KEY",
	})
	if err != nil {
		log.Fatalf("Failed to create Client: %v", err)
	}

	indexName := "restored-index"
	restoredIndexTags := pinecone.IndexTags{"restored_on": time.Now().Format("2006-01-02 15:04")}
	createIndexFromBackupResp, err := pc.CreateIndexFromBackup(ctx, &pinecone.CreateIndexFromBackupParams{
		BackupId: "e12269b0-a29b-4af0-9729-c7771dec03e3",
		Name:     indexName,
		Tags:     &restoredIndexTags,
	})

	fmt.Printf(prettifyStruct(createIndexFromBackupResp))
}

PINECONE_API_KEY="YOUR_API_KEY"
BACKUP_ID="a65ff585-d987-4da5-a622-72e19a6ed5f4"

curl "https://api.pinecone.io/backups/$BACKUP_ID/create-index" \
  -H "Api-Key: $PINECONE_API_KEY" \
  -H "X-Pinecone-Api-Version: 2025-10" \
  -H 'Content-Type: application/json' \
  -d '{
        "name": "restored-index",
        "tags": {
          "tag0": "val0",
          "tag1": "val1"
        },
        "deletion_protection": "enabled"
      }'

The example returns a response like the following:

{'deletion_protection': 'enabled',
 'dimension': 1024,
 'embed': {'dimension': 1024,
           'field_map': {'text': 'chunk_text'},
           'metric': 'cosine',
           'model': 'multilingual-e5-large',
           'read_parameters': {'input_type': 'query', 'truncate': 'END'},
           'vector_type': 'dense',
           'write_parameters': {'input_type': 'passage', 'truncate': 'END'}},
 'host': 'example-dense-index-python3-govk0nt.svc.aped-4627-b74a.pinecone.io',
 'metric': 'cosine',
 'name': 'example-dense-index-python3',
 'spec': {'serverless': {'cloud': 'aws', 'region': 'us-east-1'}},
 'status': {'ready': True, 'state': 'Ready'},
 'tags': {'tag0': 'val0', 'tag1': 'val1'},
 'vector_type': 'dense'}

{
  restoreJobId: 'e9ba8ff8-7948-4cfa-ba43-34227f6d30d4',
  indexId: '025117b3-e683-423c-b2d1-6d30fbe5027f'
}

class CreateIndexFromBackupResponse {
    restoreJobId: e9ba8ff8-7948-4cfa-ba43-34227f6d30d4
    indexId: 025117b3-e683-423c-b2d1-6d30fbe5027f
    additionalProperties: null
}

{
  "index_id": "025117b3-e683-423c-b2d1-6d30fbe5027f",
  "restore_job_id": "e9ba8ff8-7948-4cfa-ba43-34227f6d30d4"
}

{
    "restore_job_id":"e9ba8ff8-7948-4cfa-ba43-34227f6d30d4",
    "index_id":"025117b3-e683-423c-b2d1-6d30fbe5027f"
}

You can create a serverless index from a backup using the Pinecone console.

List restore jobs

You can list all restore jobs as follows.

Up to 100 restore jobs are returned at a time by default, in sorted order (bitwise “C” collation). If the limit parameter is set, up to that number of restore jobs are returned instead. Whenever there are additional restore jobs to return, the response also includes a pagination_token that you can use to get the next batch of jobs. When the response does not include a pagination_token, there are no more restore jobs to return.

from pinecone import Pinecone

pc = Pinecone(api_key="YOUR_API_KEY")

restore_jobs = pc.list_restore_jobs()

print(restore_jobs)

import { Pinecone } from '@pinecone-database/pinecone';

const pc = new Pinecone({ apiKey: 'YOUR_API_KEY' })

const restoreJobs = await pc.listRestoreJobs();

console.log(restoreJobs);

import io.pinecone.clients.Pinecone;
import org.openapitools.db_control.client.ApiException;
import org.openapitools.db_control.client.model.*;

public class CreateIndexFromBackup {
    public static void main(String[] args) throws ApiException {
        Pinecone pc = new Pinecone.Builder("YOUR_API-KEY").build();

        // List all restore jobs with default pagination limit
        RestoreJobList restoreJobList = pc.listRestoreJobs(null, null);

        // List all restore jobs with pagination limit of 5
        RestoreJobList restoreJobListWithLimit = pc.listRestoreJobs(5);

        // List all restore jobs with pagination limit and token
        RestoreJobList restoreJobListPaginated = pc.listRestoreJobs(5, "eyJza2lwX3Bhc3QiOiIxMDEwMy0=");

        System.out.println(restoreJobList);
        System.out.println(restoreJobListWithLimit);
        System.out.println(restoreJobListPaginated);
    }
}

package main

import (
	"context"
	"encoding/json"
	"fmt"
	"log"

	"github.com/pinecone-io/go-pinecone/v4/pinecone"
)

func prettifyStruct(obj interface{}) string {
	bytes, _ := json.MarshalIndent(obj, "", "  ")
	return string(bytes)
}

func main() {
	ctx := context.Background()

	pc, err := pinecone.NewClient(pinecone.NewClientParams{
		ApiKey: "YOUR_API_KEY",
	})
	if err != nil {
		log.Fatalf("Failed to create Client: %v", err)
	}

	limit := 2
	restoreJobs, err := pc.ListRestoreJobs(ctx, &pinecone.ListRestoreJobsParams{
		Limit: &limit,
	})
	if err != nil {
		log.Fatalf("Failed to list restore jobs: %v", err)
	}

	fmt.Printf(prettifyStruct(restoreJobs))
}

PINECONE_API_KEY="YOUR_API_KEY"

curl "https://api.pinecone.io/restore-jobs" \
	-H "X-Pinecone-Api-Version: 2025-10" \
	-H "Api-Key: $PINECONE_API_KEY"

The example returns a response like the following:

[{
    "restore_job_id": "06b08366-a0a9-404d-96c2-e791c71743e5",
    "backup_id": "95707edb-e482-49cf-b5a5-312219a51a97",
    "target_index_name": "restored-index",
    "target_index_id": "027aff93-de40-4f48-a573-6dbcd654f961",
    "status": "Completed",
    "created_at": "2025-05-15T13:59:51.439479+00:00",
    "completed_at": "2025-05-15T14:00:09.222998+00:00",
    "percent_complete": 100.0
}, {
    "restore_job_id": "4902f735-b876-4e53-a05c-bc01d99251cb",
    "backup_id": "8c85e612-ed1c-4f97-9f8c-8194e07bcf71",
    "target_index_name": "restored-index2",
    "target_index_id": "027aff93-de40-4f48-a573-6dbcd654f961",
    "status": "Completed",
    "created_at": "2025-05-15T21:06:19.906074+00:00",
    "completed_at": "2025-05-15T21:06:39.360509+00:00",
    "percent_complete": 100.0
}]

{
  data: [
    {
      restoreJobId: '69acc1d0-9105-4fcb-b1db-ebf97b285c5e',
      backupId: '8c85e612-ed1c-4f97-9f8c-8194e07bcf71',
      targetIndexName: 'restored-index2',
      targetIndexId: 'e6c0387f-33db-4227-9e91-32181106e56b',
      status: 'Completed',
      createdAt: 2025-05-14T17:25:59.378Z,
      completedAt: 2025-05-14T17:26:23.997Z,
      percentComplete: 100
    },
    {
      restoreJobId: '9857add2-99d4-4399-870e-aa7f15d8d326',
      backupId: '94a63aeb-efae-4f7a-b059-75d32c27ca57',
      targetIndexName: 'restored-index',
      targetIndexId: '0d8aed24-adf8-4b77-8e10-fd674309dc85',
      status: 'Completed',
      createdAt: 2025-04-25T18:14:05.227Z,
      completedAt: 2025-04-25T18:14:11.074Z,
      percentComplete: 100
    }
  ],
  pagination: undefined
}

class RestoreJobList {
    data: [class RestoreJobModel {
        restoreJobId: cf597d76-4484-4b6c-b07c-2bfcac3388aa
        backupId: 0d75b99f-be61-4a93-905e-77201286c02e
        targetIndexName: restored-index
        targetIndexId: 8a810881-1505-46c0-b906-947c048b15f5
        status: Completed
        createdAt: 2025-05-16T20:09:18.700631Z
        completedAt: 2025-05-16T20:11:30.673296Z
        percentComplete: 100.0
        additionalProperties: null
    }, class RestoreJobModel {
        restoreJobId: 4902f735-b876-4e53-a05c-bc01d99251cb
        backupId: 8c85e612-ed1c-4f97-9f8c-8194e07bcf71
        targetIndexName: restored-index2
        targetIndexId: 710cb6e6-bfb4-4bf5-a425-9754e5bbc832
        status: Completed
        createdAt: 2025-05-15T21:06:19.906074Z
        completedAt: 2025-05-15T21:06:39.360509Z
        percentComplete: 100.0
        additionalProperties: null
    }]
    pagination: class PaginationResponse {
        next: eyJsaW1pdCI6Miwib2Zmc2V0IjoyfQ==
        additionalProperties: null
    }
    additionalProperties: null
}

{
  "data": [
    {
      "backup_id": "8c85e612-ed1c-4f97-9f8c-8194e07bcf71",
      "completed_at": "2025-05-16T20:11:30.673296Z",
      "created_at": "2025-05-16T20:09:18.700631Z",
      "percent_complete": 100,
      "restore_job_id": "e9ba8ff8-7948-4cfa-ba43-34227f6d30d4",
      "status": "Completed",
      "target_index_id": "025117b3-e683-423c-b2d1-6d30fbe5027f",
      "target_index_name": "restored-index"
    },
    {
      "backup_id": "95707edb-e482-49cf-b5a5-312219a51a97",
      "completed_at": "2025-05-15T21:04:34.2463Z",
      "created_at": "2025-05-15T21:04:15.949067Z",
      "percent_complete": 100,
      "restore_job_id": "eee4f8b8-cd3e-45fe-9ed5-93c28e237f24",
      "status": "Completed",
      "target_index_id": "5a0d555f-7ccd-422a-a3a6-78f7b73350c0",
      "target_index_name": "restored-index2"
    }
  ],
  "pagination": {
    "next": "eyJsaW1pdCI6MTAsIm9mZnNldCI6MTB9"
  }
}

{
  "data": [
    {
      "restore_job_id": "9857add2-99d4-4399-870e-aa7f15d8d326",
      "backup_id": "94a63aeb-efae-4f7a-b059-75d32c27ca57",
      "target_index_name": "restored-index",
      "target_index_id": "0d8aed24-adf8-4b77-8e10-fd674309dc85",
      "status": "Completed",
      "created_at": "2025-04-25T18:14:05.227526Z",
      "completed_at": "2025-04-25T18:14:11.074618Z",
      "percent_complete": 100
    },
    {
      "restore_job_id": "69acc1d0-9105-4fcb-b1db-ebf97b285c5e",
      "backup_id": "8c85e612-ed1c-4f97-9f8c-8194e07bcf71",
      "target_index_name": "restored-index2",
      "target_index_id": "e6c0387f-33db-4227-9e91-32181106e56b",
      "status": "Completed",
      "created_at": "2025-05-14T17:25:59.378989Z",
      "completed_at": "2025-05-14T17:26:23.997284Z",
      "percent_complete": 100
    }
  ],
  "pagination": null
}

View restore job details

You can view the details of a specific restore job, as in the following example:

from pinecone import Pinecone

pc = Pinecone(api_key="YOUR_API_KEY")

restore_job = pc.describe_restore_job(job_id="9857add2-99d4-4399-870e-aa7f15d8d326")

print(restore_job)

import { Pinecone } from '@pinecone-database/pinecone';

const pc = new Pinecone({ apiKey: 'YOUR_API_KEY' })

const restoreJob = await pc.describeRestoreJob('9857add2-99d4-4399-870e-aa7f15d8d326');

console.log(restoreJob);

import io.pinecone.clients.Pinecone;
import org.openapitools.db_control.client.ApiException;
import org.openapitools.db_control.client.model.*;

public class CreateIndexFromBackup {
    public static void main(String[] args) throws ApiException {
        Pinecone pc = new Pinecone.Builder("YOUR_API-KEY").build();

        RestoreJobModel restoreJob = pc.describeRestoreJob("9857add2-99d4-4399-870e-aa7f15d8d326");

        System.out.println(restoreJob);
    }
}

package main

import (
	"context"
	"encoding/json"
	"fmt"
	"log"

	"github.com/pinecone-io/go-pinecone/v4/pinecone"
)

func prettifyStruct(obj interface{}) string {
	bytes, _ := json.MarshalIndent(obj, "", "  ")
	return string(bytes)
}

func main() {
	ctx := context.Background()

	pc, err := pinecone.NewClient(pinecone.NewClientParams{
		ApiKey: "YOUR_API_KEY",
	})
	if err != nil {
		log.Fatalf("Failed to create Client: %v", err)
	}

	restoreJob, err := pc.DescribeRestoreJob(ctx, "e9ba8ff8-7948-4cfa-ba43-34227f6d30d4")
	if err != nil {
		log.Fatalf("Failed to describe restore job: %v", err)
	}

	fmt.Printf(prettifyStruct(restoreJob))
}

PINECONE_API_KEY="YOUR_API_KEY"
JOB_ID="9857add2-99d4-4399-870e-aa7f15d8d326"

curl "https://api.pinecone.io/restore-jobs/$JOB_ID" \
    -H "X-Pinecone-Api-Version: 2025-10" \
    -H "Api-Key: $PINECONE_API_KEY" \
    -H 'accept: application/json'

The example returns a response like the following:

{'backup_id': '94a63aeb-efae-4f7a-b059-75d32c27ca57',
 'completed_at': datetime.datetime(2025, 4, 25, 18, 14, 11, 74618, tzinfo=tzutc()),
 'created_at': datetime.datetime(2025, 4, 25, 18, 14, 5, 227526, tzinfo=tzutc()),
 'percent_complete': 100.0,
 'restore_job_id': '9857add2-99d4-4399-870e-aa7f15d8d326',
 'status': 'Completed',
 'target_index_id': '0d8aed24-adf8-4b77-8e10-fd674309dc85',
 'target_index_name': 'restored-index'}

{
  restoreJobId: '9857add2-99d4-4399-870e-aa7f15d8d326',
  backupId: '94a63aeb-efae-4f7a-b059-75d32c27ca57',
  targetIndexName: 'restored-index',
  targetIndexId: '0d8aed24-adf8-4b77-8e10-fd674309dc85',
  status: 'Completed',
  createdAt: 2025-04-25T18:14:05.227Z,
  completedAt: 2025-04-25T18:14:11.074Z,
  percentComplete: 100
}

class RestoreJobModel {
    restoreJobId: cf597d76-4484-4b6c-b07c-2bfcac3388aa
    backupId: 0d75b99f-be61-4a93-905e-77201286c02e
    targetIndexName: restored-index
    targetIndexId: 0d8aed24-adf8-4b77-8e10-fd674309dc85
    status: Completed
    createdAt: 2025-05-16T20:09:18.700631Z
    completedAt: 2025-05-16T20:11:30.673296Z
    percentComplete: 100.0
    additionalProperties: null
}

{
  "backup_id": "8c85e612-ed1c-4f97-9f8c-8194e07bcf71",
  "completed_at": "2025-05-16T20:11:30.673296Z",
  "created_at": "2025-05-16T20:09:18.700631Z",
  "percent_complete": 100,
  "restore_job_id": "e9ba8ff8-7948-4cfa-ba43-34227f6d30d4",
  "status": "Completed",
  "target_index_id": "025117b3-e683-423c-b2d1-6d30fbe5027f",
  "target_index_name": "restored-index"
}

{
  "restore_job_id": "9857add2-99d4-4399-870e-aa7f15d8d326",
  "backup_id": "94a63aeb-efae-4f7a-b059-75d32c27ca57",
  "target_index_name": "restored-index",
  "target_index_id": "0d8aed24-adf8-4b77-8e10-fd674309dc85",
  "status": "Completed",
  "created_at": "2025-04-25T18:14:05.227526Z",
  "completed_at": "2025-04-25T18:14:11.074618Z",
  "percent_complete": 100
}

​Create a serverless index from a backup

​List restore jobs

​View restore job details

Create a serverless index from a backup

List restore jobs

View restore job details