# Pinecone APIs and domains

This page lists the Pinecone API calls, corresponding SDK methods, their purpose in backups/restores/browses, and the domain endpoints used by each.

## API calls and SDK methods

API Call | SDK Method | Purpose
--- | --- | ---
Client Init | `Pinecone(api_key=...)` | Authenticate
List Indexes | `pc.list_indexes()` | Browse, restore, machineBrowse
Create Index | `pc.create_index(...)` + `ServerlessSpec` | Restore (create target index)
Describe Index | `pc.describe_index(index_name)` | Fetch index metadata (dimension, region, etc.)
Connect to Index | `pc.Index(index_name)` | Open data-plane connection
Describe Index Stats | `index.describe_index_stats()` | Get namespace list + vector counts
List Vector IDs | `index.list(namespace=..., limit=...)` | Backup - enumerate all IDs
Fetch Vectors | `index.fetch(ids=..., namespace=...)` | Backup - retrieve vector data
Start Import | `index.start_import(uri=..., integration_id=..., error_mode=...)` | Restore - bulk import from object storage
Describe Import | `index.describe_import(import_id)` | Restore - poll import status
List Imports | `index.list_imports()` | Restore - enumerate imports
Delete Namespace | `index.delete_namespace(namespace=...)` | In-place restore - purge before re-import

## Domains used

Domain | Used For
--- | ---
`api.pinecone.io` | Control plane: `list_indexes`, `create_index`, `describe_index`
`*.svc.*.pinecone.io` | Data plane (per-index host): all vector ops, import, stats, delete namespace
`*.pinecone.io` | Catch-all (covers both above)

## Whitelist recommendation

The following entries can be whitelisted for backups/restores/browses:

- `*.pinecone.io`
- `pinecone.io`

×

Loading...