How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Pinecone Manage Indexes API

Actions that manage indexes

Pinecone Manage Indexes API is one of 9 APIs that Pinecone publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Manage Indexes. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 18 operations across 11 paths, and defines 36 schemas. It is described by OpenAPI 3.2.0, at version 2025-10.

Requests are made against a single base URL, https://api.pinecone.io.

18 operations 11 paths 36 schemas 3 DELETE9 GET1 PATCH5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2025-10
Base URL
https://api.pinecone.io
Authentication
API Key
License
Resource Areas
1

Authentication & Security 1

Pinecone Manage Indexes API declares 1 security scheme for authenticating requests. An API key is passed in the header as Api-Key (ApiKeyAuth). By default, every request must be authenticated.

  • ApiKeyAuth — An API Key is required to call Pinecone APIs. Get yours from the [console](https://app.pinecone.io/).

Paths & Operations 18

Across 11 paths, the API surfaces 18 operations — 3 DELETE, 9 GET, 1 PATCH, 5 POST. Each is listed below with its method, path, parameters, and response codes.

Manage Indexes 18

Actions that manage indexes

GET
/indexes
List indexes
list_indexes 1 param → 200401500
POST
/indexes
Create an index
create_index 1 param body → 201400401402403404422409
GET
/indexes/{index_name}
Describe an index
describe_index 2 params → 200401404500
DELETE
/indexes/{index_name}
Delete an index
delete_index 2 params → 202401403404412500
PATCH
/indexes/{index_name}
Configure an index
configure_index 2 params body → 202400401402403404422500
GET
/indexes/{index_name}/backups
List backups for an index
list_index_backups 4 params → 200401404500
POST
/indexes/{index_name}/backups
Create a backup of an index
create_backup 2 params body → 201400401402403422500
GET
/collections
List collections
list_collections 1 param → 200401500
POST
/collections
Create a collection
create_collection 1 param body → 201400401402403409422500
POST
/indexes/create-for-model
Create an index with integrated embedding
create_index_for_model 1 param body → 201400401404409422500
GET
/backups
List backups for all indexes in a project
list_project_backups 3 params → 200401500
GET
/backups/{backup_id}
Describe a backup
describe_backup 2 params → 200401404500
DELETE
/backups/{backup_id}
Delete a backup
delete_backup 2 params → 202401404412500
POST
/backups/{backup_id}/create-index
Create an index from a backup
create_index_from_backup_operation 2 params body → 202400401402403404409422
GET
/restore-jobs
List restore jobs
list_restore_jobs 3 params → 200401500
GET
/restore-jobs/{job_id}
Describe a restore job
describe_restore_job 2 params → 200401404500
GET
/collections/{collection_name}
Describe a collection
describe_collection 2 params → 200401404500
DELETE
/collections/{collection_name}
Delete a collection
delete_collection 2 params → 202401404500

Schemas 36

The contract defines 36 schemas that model the data the API accepts and returns. The most detailed are BackupModel (16 properties), IndexModel (11 properties), RestoreJobModel (8 properties), CreateIndexForModelRequest (8 properties). Each schema is shown below with its type and property counts.

BackupModel
object
The BackupModel describes the configuration and status of a Pinecone backup.
16 properties 6 required
ServerlessSpecResponse
object
Configuration of a serverless index.
5 properties 3 required
ReadCapacityDedicatedSpecResponse
object
3 properties 3 required
ReadCapacityStatus
object
The current status of factors affecting the read capacity of a serverless index
4 properties 1 required
ServerlessSpec
object
Configuration needed to deploy a serverless index.
5 properties 2 required
DeletionProtection
string
Whether [deletion protection](http://docs.pinecone.io/guides/manage-data/manage-indexesconfigure-deletion-protection) is enabled/disabled for the index. Possib…
ModelIndexEmbed
object
The embedding model and document fields mapped to embedding inputs.
7 properties 1 required
CreateBackupRequest
object
The configuration needed to create a backup of an index.
2 properties
ReadCapacityOnDemandSpecResponse
object
2 properties 2 required
ReadCapacity
By default the index will be created with read capacity mode OnDemand. If you prefer to allocate dedicated read nodes for your workload, you must specify mode…
ByocSpecResponse
object
Configuration of a BYOC index.
3 properties 2 required
CreateIndexFromBackupResponse
object
The response for creating an index from a backup.
2 properties 2 required
IndexModel
object
The IndexModel describes the configuration and status of a Pinecone index.
11 properties 6 required
BackupList
object
The list of backups that exist in the project.
2 properties
RestoreJobModel
object
The RestoreJobModel describes the status of a restore job.
8 properties 6 required
PodSpec
object
Configuration needed to deploy a pod-based index.
7 properties 2 required
CollectionList
object
The list of collections that exist in the project.
1 property
IndexTags
object
Custom user tags added to an index. Keys must be 80 characters or less. Values must be 120 characters or less. Keys must be alphanumeric, '', or '-'. Values mu…
CollectionModel
object
The CollectionModel describes the configuration and status of a Pinecone collection.
6 properties 3 required
ConfigureIndexRequest
object
Configuration used to scale an index.
4 properties
ByocSpec
object
Configuration needed to deploy an index in a BYOC environment.
3 properties 1 required
IndexSpec
object
The spec object defines how the index should be deployed. For serverless indexes, you define only the [cloud and region](http://docs.pinecone.io/guides/index-d…
CreateIndexFromBackupRequest
object
The configuration needed to create a Pinecone index from a backup.
3 properties 1 required
CreateCollectionRequest
object
The configuration needed to create a Pinecone collection.
2 properties 2 required
ScalingConfigManual
object
The config to use for manual read capacity scaling.
2 properties
CreateIndexForModelRequest
object
The desired configuration for the index and associated embedding model.
8 properties 4 required
ReadCapacityOnDemandSpec
object
1 property 1 required
ReadCapacityResponse
Response containing read capacity configuration
IndexList
object
The list of indexes that exist in the project.
1 property
ReadCapacityDedicatedConfig
object
Configuration for dedicated read capacity. See [this guide](https://docs.pinecone.io/guides/index-data/dedicated-read-nodes) for more details on how to configu…
3 properties
MetadataSchema
object
Schema for the behavior of Pinecone's internal metadata index. By default, all metadata is indexed; when schema is present, only fields which are present in th…
1 property 1 required
PaginationResponse
object
The pagination object that is returned with paginated responses.
1 property 1 required
ReadCapacityDedicatedSpec
object
2 properties 2 required
ErrorResponse
object
The response shape used for all error responses.
2 properties 2 required
RestoreJobList
object
The list of restore jobs that exist in the project.
2 properties 1 required
CreateIndexRequest
object
The configuration needed to create a Pinecone index.
7 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

pinecone-manage-indexes-api-openapi.yml Raw ↑

Other APIs Pinecone publishes across the network.

Pinecone API Keys API
Pinecone Bulk Operations API
Pinecone Inference API
Pinecone Manage Assistants API
Pinecone Namespace Operations API
Pinecone Organizations API
Pinecone Projects API
Pinecone Vector Operations API
Where this information came from

This is an independent, third-party profile of Pinecone Manage Indexes API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.