# Pinecone Control Plane API API

> Pinecone Control Plane API API on Apizie: 18 endpoints (List indexes, Create an index, Describe an index, Configure an index, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/ai:pinecone/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `ai:pinecone`
- Category: Artificial Intelligence
- Status: byok
- Source: https://support.pinecone.io
- Page: https://zieapi.vercel.app/api/ai/pinecone
- OpenAPI: https://zieapi.vercel.app/api/ai/pinecone/openapi.json

Pinecone is a vector database that makes it easy to search and retrieve billions of high-dimensional vectors.

## Endpoints

### List indexes
`GET https://zieapi.vercel.app/v1/ai:pinecone/list-indexes` (byok)

### Create an index
`POST https://zieapi.vercel.app/v1/ai:pinecone/create-index` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Describe an index
`GET https://zieapi.vercel.app/v1/ai:pinecone/describe-index` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| index_name | string | yes | The name of the index to be described. |

### Configure an index
`POST https://zieapi.vercel.app/v1/ai:pinecone/configure-index` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| index_name | string | yes | The name of the index to configure. |
| body | object | yes | JSON request body |

### Delete an index
`POST https://zieapi.vercel.app/v1/ai:pinecone/delete-index` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| index_name | string | yes | The name of the index to delete. |

### List backups for an index
`GET https://zieapi.vercel.app/v1/ai:pinecone/list-index-backups` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| index_name | string | yes | Name of the backed up index |
| limit | integer | no | The number of results to return per page. |
| paginationToken | string | no | The token to use to retrieve the next page of results. |

### Create a backup of an index
`POST https://zieapi.vercel.app/v1/ai:pinecone/create-backup` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| index_name | string | yes | Name of the index to backup |
| body | object | yes | JSON request body |

### List collections
`GET https://zieapi.vercel.app/v1/ai:pinecone/list-collections` (byok)

### Create a collection
`POST https://zieapi.vercel.app/v1/ai:pinecone/create-collection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Create an index with integrated embedding
`POST https://zieapi.vercel.app/v1/ai:pinecone/create-index-for-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### List backups for all indexes in a project
`GET https://zieapi.vercel.app/v1/ai:pinecone/list-project-backups` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | no | The number of results to return per page. |
| paginationToken | string | no | The token to use to retrieve the next page of results. |

### Describe a backup
`GET https://zieapi.vercel.app/v1/ai:pinecone/describe-backup` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| backup_id | string | yes | The ID of the backup to describe. |

### Delete a backup
`POST https://zieapi.vercel.app/v1/ai:pinecone/delete-backup` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| backup_id | string | yes | The ID of the backup to delete. |

### Create an index from a backup
`POST https://zieapi.vercel.app/v1/ai:pinecone/create-index-from-backup-operation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| backup_id | string | yes | The ID of the backup to create an index from. |
| body | object | yes | JSON request body |

### List restore jobs
`GET https://zieapi.vercel.app/v1/ai:pinecone/list-restore-jobs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | no | The number of results to return per page. |
| paginationToken | string | no | The token to use to retrieve the next page of results. |

### Describe a restore job
`GET https://zieapi.vercel.app/v1/ai:pinecone/describe-restore-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| job_id | string | yes | The ID of the restore job to describe. |

### Describe a collection
`GET https://zieapi.vercel.app/v1/ai:pinecone/describe-collection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| collection_name | string | yes | The name of the collection to be described. |

### Delete a collection
`POST https://zieapi.vercel.app/v1/ai:pinecone/delete-collection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| collection_name | string | yes | The name of the collection. |

## Example
```
curl "https://zieapi.vercel.app/v1/ai:pinecone/list-indexes" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Pinecone Control Plane API API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/ai:pinecone/list-indexes with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Pinecone Control Plane API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Pinecone Control Plane API itself also needs your own key from pinecone.

### Can AI agents use the Pinecone Control Plane API API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key ai:pinecone.

### What is the status of the Pinecone Control Plane API API?
Needs your own provider key (bring your own key)
