---
title: "Start import"
method: POST
path: "/bulk/imports"
tags: ["Bulk Operations"]
---

# Start import

`POST /bulk/imports`

Start an asynchronous import of vectors from object storage into an index.

For guidance and examples, see [Import data](https://docs.pinecone.io/guides/index-data/import-data).

## Headers

- `X-Pinecone-Api-Version` string, required

## Request body

- DbDataStartImportRequest — The request for the `start_import` operation.
  - `integrationId` string — The id of the [storage integration](https://docs.pinecone.io/guides/operations/integrations/manage-storage-integrations) that should be used to access the data.
  - `uri` string, required — The URI of the bucket (or container) and import directory containing the namespaces and Parquet files you want to import. For example, `s3://BUCKET_NAME/IMPORT_DIR` for Amazon S3, `gs://BUCKET_NAME/IMPORT_DIR` for Google Cloud Storage, or `https://STORAGE_ACCOUNT.blob.core.windows.net/CONTAINER_NAME/IMPORT_DIR` for Azure Blob Storage. For more information, see [Import records](https://docs.pinecone.io/guides/index-data/import-data#prepare-your-data).
  - `errorMode` DbDataImportErrorMode — Indicates how to respond to errors during the import process.
    - `onError` string — Indicates how to respond to errors during the import process. Possible values: `abort` or `continue`.

## Response `200`

Successful import operation

- DbDataStartImportResponse — The response for the `start_import` operation.
  - `id` string — Unique identifier for the import operation.

## Other responses

- `400` — Bad request. The request body included invalid request parameters.
- `4XX` — An unexpected error response.
- `5XX` — An unexpected error response.

---

[API](https://skmtc.net/pinecone/apis/pinecone-api.md) · [All operations](https://skmtc.net/pinecone/apis/pinecone-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pinecone/pinecone-api/versions/35876583485d/schema)