Pinecone website screenshot

Pinecone

With its vector database at the core, Pinecone is the leading knowledge platform for building accurate, secure, and scalable AI applications. The Pinecone APIs cover Database (vector storage and search), Inference (embeddings and reranking), Assistant (RAG over documents), and Admin (organization and project management).

Pinecone publishes 6 APIs on the APIs.io network, including Database Control API, Database Data API, Inference API, and 3 more. Tagged areas include Vector Databases, AI, Embeddings, and RAG.

The Pinecone catalog on APIs.io includes 1 Spectral governance ruleset.

Pinecone’s developer surface includes authentication, pricing, engineering blog, documentation, getting-started guide, code examples, changelog, and 16 more developer resources.

62.9/100 strong ▼ -5.6 Agent 34/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
6 APIs 16 Features
Vector DatabasesAIEmbeddingsRAG

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 62.9/100 · strong
Contract Quality 13.6 / 25
Developer Ergonomics 7.8 / 20
Commercial Clarity 18.4 / 20
Operational Transparency 9.6 / 13
Governance 7.0 / 12
Discoverability 6.5 / 10
Agent readiness — 34/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 8 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/pinecone: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 6

Individual APIs this provider publishes, each with its own machine-readable definition.

Pinecone Database Control API

Use the Database Control API to manage indexes, collections, and backups in Pinecone Database. The control plane handles lifecycle and configuration of vector storage resources.

Pinecone Database Data API

Use the Database Data API to upsert, query, fetch, update, and delete vector records in Pinecone indexes. The data plane is the high-throughput interface for real-time vector se...

Pinecone Inference API

Use the Inference API to generate vector embeddings and rerank results using models hosted on Pinecone's infrastructure.

Pinecone Assistant Control API

Use the Assistant Control API to create and manage Pinecone Assistants for retrieval-augmented generation (RAG) over your documents.

Pinecone Assistant Data API

Use the Assistant Data API to upload documents to a Pinecone Assistant, ask questions, and receive responses grounded in those documents.

Pinecone Admin API

Use the Admin API to manage Pinecone organizations, projects, API keys, and service accounts at the platform level.

Postman Collections 9

Ready-to-run Postman collections for exercising this provider's APIs.

Scroll for all 9

GraphQL 1

GraphQL schemas published by this provider.

Pinecone GraphQL API

Pinecone is a managed vector database for AI applications. The API covers index management, upsert and query of vector embeddings, metadata filtering, sparse-dense hybrid search...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Pinecone Rate Limits

4 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Features 16

Notable capabilities this provider offers.

Starter free: 2 GB, 2M writes, 1M reads
Builder at $20/mo flat: 10 GB, 5M writes, 2M reads
Standard $50/mo min: $0.33/GB, $4-$4.50/M writes, $16-$18/M reads
Enterprise $500/mo min: $6-$6.75/M writes, $24-$27/M reads, 99.95% SLA
Serverless indexes (auto-scaling)
Pod-based (legacy) for reserved capacity
REST and gRPC APIs
OpenAPI spec available
Hybrid search (dense + sparse vectors)
Namespaces for multi-tenancy
Bulk import from S3/GCS/Azure
Up to 1,000 vectors per upsert request
Dedicated Read Nodes for QPS isolation
Backup/restore on Standard+
SAML SSO and audit logs (Enterprise)
Inference API for embeddings + reranking

Scroll for all 16

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Pinecone API Rules

5 rules · 4 warnings 1 info

SPECTRAL

JSON Schema 136

Standalone JSON Schema definitions for this provider's data models.

APIKey

4 properties

JSON SCHEMA

APIKeyWithSecret

2 properties

JSON SCHEMA

Assistant

7 properties

JSON SCHEMA

AssistantFileModel

10 properties

JSON SCHEMA

BackupList

2 properties

JSON SCHEMA

BackupModel

16 properties

JSON SCHEMA

BYOC

3 properties

JSON SCHEMA

BYOC

3 properties

JSON SCHEMA

CancelImportResponse

0 properties

JSON SCHEMA

ChatCompletionModel

4 properties

JSON SCHEMA

ChatModel

6 properties

JSON SCHEMA

ChatRequest

8 properties

JSON SCHEMA

ChoiceChunkModel

3 properties

JSON SCHEMA

ChoiceModel

3 properties

JSON SCHEMA

CitationModel

2 properties

JSON SCHEMA

CollectionList

1 properties

JSON SCHEMA

CollectionModel

6 properties

JSON SCHEMA

ConfigureIndexRequest

4 properties

JSON SCHEMA

ContextModel

3 properties

JSON SCHEMA

ContextOptionsModel

4 properties

JSON SCHEMA

ContextRequest

7 properties

JSON SCHEMA

CreateAPIKeyRequest

2 properties

JSON SCHEMA

CreateBackupRequest

2 properties

JSON SCHEMA

CreateCollectionRequest

2 properties

JSON SCHEMA

CreateIndexForModelRequest

8 properties

JSON SCHEMA

CreateIndexFromBackupRequest

3 properties

JSON SCHEMA

CreateIndexFromBackupResponse

2 properties

JSON SCHEMA

CreateIndexRequest

7 properties

JSON SCHEMA

CreateNamespaceRequest

2 properties

JSON SCHEMA

CreateProjectRequest

3 properties

JSON SCHEMA

DeleteRequest

4 properties

JSON SCHEMA

DeleteResponse

0 properties

JSON SCHEMA

DeletionProtection

0 properties

JSON SCHEMA

Dense embedding

2 properties

JSON SCHEMA

DescribeIndexStatsRequest

1 properties

JSON SCHEMA

Document

0 properties

JSON SCHEMA

DocxReferenceModel

3 properties

JSON SCHEMA

Embedding

0 properties

JSON SCHEMA

EmbeddingsList

4 properties

JSON SCHEMA

EmbedInputs

0 properties

JSON SCHEMA

EmbedRequest

3 properties

JSON SCHEMA

ErrorResponse

2 properties

JSON SCHEMA

FetchByMetadataRequest

4 properties

JSON SCHEMA

FetchByMetadataResponse

4 properties

JSON SCHEMA

FetchResponse

3 properties

JSON SCHEMA

HighlightModel

2 properties

JSON SCHEMA

Hit

3 properties

JSON SCHEMA

ImageModel

3 properties

JSON SCHEMA

ImportErrorMode

1 properties

JSON SCHEMA

ImportModel

8 properties

JSON SCHEMA

IndexDescription

8 properties

JSON SCHEMA

IndexList

1 properties

JSON SCHEMA

IndexModel

11 properties

JSON SCHEMA

IndexSpec

0 properties

JSON SCHEMA

IndexTags

0 properties

JSON SCHEMA

JsonReferenceModel

2 properties

JSON SCHEMA

ListApiKeysResponse

1 properties

JSON SCHEMA

ListImportsResponse

2 properties

JSON SCHEMA

ListItem

1 properties

JSON SCHEMA

ListNamespacesResponse

3 properties

JSON SCHEMA

ListResponse

4 properties

JSON SCHEMA

MarkdownReferenceModel

2 properties

JSON SCHEMA

MessageModel

2 properties

JSON SCHEMA

MetadataSchema

1 properties

JSON SCHEMA

ModelIndexEmbed

7 properties

JSON SCHEMA

ModelInfo

12 properties

JSON SCHEMA

ModelInfoList

1 properties

JSON SCHEMA

ModelInfoMetric

0 properties

JSON SCHEMA

ModelInfoSupportedMetrics

0 properties

JSON SCHEMA

ModelInfoSupportedParameter

8 properties

JSON SCHEMA

MultiModalContentBlocksModel

0 properties

JSON SCHEMA

MultiModalContentImageBlockModel

3 properties

JSON SCHEMA

MultiModalContentTextBlockModel

2 properties

JSON SCHEMA

MultiModalSnippetModel

4 properties

JSON SCHEMA

NamespaceDescription

4 properties

JSON SCHEMA

NamespaceSummary

1 properties

JSON SCHEMA

Organization

6 properties

JSON SCHEMA

OrganizationList

1 properties

JSON SCHEMA

Pagination

1 properties

JSON SCHEMA

PaginationResponse

1 properties

JSON SCHEMA

PdfReferenceModel

3 properties

JSON SCHEMA

Pod-based

7 properties

JSON SCHEMA

Project

6 properties

JSON SCHEMA

ProjectList

1 properties

JSON SCHEMA

protobufAny

2 properties

JSON SCHEMA

QueryRequest

11 properties

JSON SCHEMA

QueryResponse

4 properties

JSON SCHEMA

QueryVector

5 properties

JSON SCHEMA

RankedDocument

3 properties

JSON SCHEMA

ReadCapacity

0 properties

JSON SCHEMA

ReadCapacityDedicatedConfig

3 properties

JSON SCHEMA

Dedicated

2 properties

JSON SCHEMA

Dedicated

3 properties

JSON SCHEMA

On-demand

1 properties

JSON SCHEMA

On-demand

2 properties

JSON SCHEMA

ReadCapacityResponse

0 properties

JSON SCHEMA

ReadCapacityStatus

4 properties

JSON SCHEMA

ReferenceModel

3 properties

JSON SCHEMA

RerankRequest

7 properties

JSON SCHEMA

RerankResult

3 properties

JSON SCHEMA

RestoreJobList

2 properties

JSON SCHEMA

RestoreJobModel

8 properties

JSON SCHEMA

rpcStatus

3 properties

JSON SCHEMA

ScalingConfigManual

2 properties

JSON SCHEMA

ScoredVector

5 properties

JSON SCHEMA

SearchCompletions

5 properties

JSON SCHEMA

SearchMatchTerms

2 properties

JSON SCHEMA

SearchRecordsRequest

3 properties

JSON SCHEMA

SearchRecordsResponse

2 properties

JSON SCHEMA

SearchRecordsVector

3 properties

JSON SCHEMA

SearchUsage

3 properties

JSON SCHEMA

Serverless

5 properties

JSON SCHEMA

ServerlessSpecResponse

5 properties

JSON SCHEMA

SnippetModel

0 properties

JSON SCHEMA

Sparse embedding

4 properties

JSON SCHEMA

SparseValues

2 properties

JSON SCHEMA

StartImportRequest

3 properties

JSON SCHEMA

StartImportResponse

1 properties

JSON SCHEMA

StreamChatCompletionChunkModel

3 properties

JSON SCHEMA

TextReferenceModel

2 properties

JSON SCHEMA

TextSnippetModel

4 properties

JSON SCHEMA

TypedReferenceModel

0 properties

JSON SCHEMA

UpdateAPIKeyRequest

2 properties

JSON SCHEMA

UpdateOrganizationRequest

1 properties

JSON SCHEMA

UpdateProjectRequest

3 properties

JSON SCHEMA

UpdateRequest

7 properties

JSON SCHEMA

UpdateResponse

1 properties

JSON SCHEMA

UpsertRecord

1 properties

JSON SCHEMA

UpsertRequest

2 properties

JSON SCHEMA

UpsertResponse

1 properties

JSON SCHEMA

Usage

1 properties

JSON SCHEMA

UsageModel

3 properties

JSON SCHEMA

Vector

4 properties

JSON SCHEMA

VectorType

0 properties

JSON SCHEMA

VectorValues

0 properties

JSON SCHEMA

Scroll for all 136

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Pinecone Structure

0 properties

JSON STRUCTURE

Examples 47

Example request and response payloads for these APIs.

Pinecone Embed Example

6 fields

EXAMPLE

Pinecone Rerank Example

6 fields

EXAMPLE

Scroll for all 47

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Pinecone Authentication

apiKey/http · 2 schemes

SECURITY

Pinecone Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Pinecone Trust Center

SOC 2, ISO 27001, HIPAA, GDPR

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Pinecone Agentic Access

66 operations · 39 acting

66 operations · 39 acting

AGENTIC

Resources

Get Started 2

Portal, sign-up, and the first successful call

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

Build 2

SDKs, sample code, and the tooling you integrate with

Access & Security 4

Authentication, authorization, and security posture

Operate 2

Status, limits, changes, and where to get help

Commercial 3

Pricing, plans, and the legal terms of use

Company 4

The organization behind the API

Other 3

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: pinecone
name: Pinecone
description: With its vector database at the core, Pinecone is the leading knowledge platform for building accurate, secure,
  and scalable AI applications. The Pinecone APIs cover Database (vector storage and search), Inference (embeddings and reranking),
  Assistant (RAG over documents), and Admin (organization and project management).
kind: contract
position: Consumer
access: 3rd-Party
image: https://kinlane-productions2.s3.amazonaws.com/apis-json-icons/introduction-pinecone-docs.png
tags:
- Vector Databases
- AI
- Embeddings
- RAG
created: '2024-07-02'
modified: '2026-05-19'
url: https://raw.githubusercontent.com/api-evangelist/pinecone/refs/heads/main/apis.yml
specificationVersion: '0.19'
apis:
- aid: pinecone:pinecone-database-control
  name: Pinecone Database Control API
  description: Use the Database Control API to manage indexes, collections, and backups in Pinecone Database. The control
    plane handles lifecycle and configuration of vector storage resources.
  humanURL: https://docs.pinecone.io/reference/api/introduction
  baseURL: https://api.pinecone.io
  tags:
  - Vector Databases
  - Indexes
  - Control Plane
  properties:
  - type: Documentation
    url: https://docs.pinecone.io/reference/api/introduction
  - type: OpenAPI
    url: https://raw.githubusercontent.com/api-evangelist/pinecone/refs/heads/main/openapi/pinecone-db-control-openapi.yaml
  - url: graphql/pinecone-graphql.md
    type: GraphQL
- aid: pinecone:pinecone-database-data
  name: Pinecone Database Data API
  description: Use the Database Data API to upsert, query, fetch, update, and delete vector records in Pinecone indexes. The
    data plane is the high-throughput interface for real-time vector search.
  humanURL: https://docs.pinecone.io/reference/api/introduction
  baseURL: https://{index_host}
  tags:
  - Vector Databases
  - Vectors
  - Data Plane
  properties:
  - type: Documentation
    url: https://docs.pinecone.io/reference/api/introduction
  - type: OpenAPI
    url: https://raw.githubusercontent.com/api-evangelist/pinecone/refs/heads/main/openapi/pinecone-db-data-openapi.yaml
- aid: pinecone:pinecone-inference
  name: Pinecone Inference API
  description: Use the Inference API to generate vector embeddings and rerank results using models hosted on Pinecone's infrastructure.
  humanURL: https://docs.pinecone.io/reference/api/introduction#inference-api
  baseURL: https://api.pinecone.io
  tags:
  - Embeddings
  - Reranking
  - AI
  properties:
  - type: Documentation
    url: https://docs.pinecone.io/reference/api/introduction#inference-api
  - type: OpenAPI
    url: https://raw.githubusercontent.com/api-evangelist/pinecone/refs/heads/main/openapi/pinecone-inference-openapi.yaml
- aid: pinecone:pinecone-assistant-control
  name: Pinecone Assistant Control API
  description: Use the Assistant Control API to create and manage Pinecone Assistants for retrieval-augmented generation (RAG)
    over your documents.
  humanURL: https://docs.pinecone.io/reference/api/introduction#assistant-api
  baseURL: https://api.pinecone.io
  tags:
  - Assistants
  - RAG
  - Control Plane
  properties:
  - type: Documentation
    url: https://docs.pinecone.io/reference/api/introduction#assistant-api
  - type: OpenAPI
    url: https://raw.githubusercontent.com/api-evangelist/pinecone/refs/heads/main/openapi/pinecone-assistant-control-openapi.yaml
- aid: pinecone:pinecone-assistant-data
  name: Pinecone Assistant Data API
  description: Use the Assistant Data API to upload documents to a Pinecone Assistant, ask questions, and receive responses
    grounded in those documents.
  humanURL: https://docs.pinecone.io/reference/api/introduction#assistant-api
  baseURL: https://prod-1-data.ke.pinecone.io
  tags:
  - Assistants
  - RAG
  - Data Plane
  properties:
  - type: Documentation
    url: https://docs.pinecone.io/reference/api/introduction#assistant-api
  - type: OpenAPI
    url: https://raw.githubusercontent.com/api-evangelist/pinecone/refs/heads/main/openapi/pinecone-assistant-data-openapi.yaml
- aid: pinecone:pinecone-admin
  name: Pinecone Admin API
  description: Use the Admin API to manage Pinecone organizations, projects, API keys, and service accounts at the platform
    level.
  humanURL: https://docs.pinecone.io/reference/api/introduction
  baseURL: https://api.pinecone.io
  tags:
  - Admin
  - Organizations
  - Projects
  properties:
  - type: Documentation
    url: https://docs.pinecone.io/reference/api/introduction
  - type: OpenAPI
    url: https://raw.githubusercontent.com/api-evangelist/pinecone/refs/heads/main/openapi/pinecone-admin-openapi.yaml
common:
- type: AgentCard
  url: a2a/pinecone-a2a.yml
  name: A2A Agent Card
  description: Agent Card served at /.well-known/agent-card.json (flavored against A2A 1.0.0).
- type: AgenticAccess
  url: agentic-access/pinecone-agentic-access.yml
- type: TrustCenter
  url: security/pinecone-trust-center.yml
- type: DomainSecurity
  url: security/pinecone-domain-security.yml
- type: Authentication
  url: authentication/pinecone-authentication.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/pinecone-io
- type: Website
  url: https://www.pinecone.io/
- type: Pricing
  url: https://www.pinecone.io/pricing/
- type: Blog
  url: https://www.pinecone.io/blog/
- type: Newsroom
  url: https://www.pinecone.io/newsroom/news/
- type: Documentation
  url: https://docs.pinecone.io/guides/get-started/overview
- type: GettingStarted
  url: https://docs.pinecone.io/guides/get-started/overview
- type: Features
  url: https://docs.pinecone.io/guides/get-started/key-features
  data:
  - 'Starter free: 2 GB, 2M writes, 1M reads'
  - 'Builder at $20/mo flat: 10 GB, 5M writes, 2M reads'
  - 'Standard $50/mo min: $0.33/GB, $4-$4.50/M writes, $16-$18/M reads'
  - 'Enterprise $500/mo min: $6-$6.75/M writes, $24-$27/M reads, 99.95% SLA'
  - Serverless indexes (auto-scaling)
  - Pod-based (legacy) for reserved capacity
  - REST and gRPC APIs
  - OpenAPI spec available
  - Hybrid search (dense + sparse vectors)
  - Namespaces for multi-tenancy
  - Bulk import from S3/GCS/Azure
  - Up to 1,000 vectors per upsert request
  - Dedicated Read Nodes for QPS isolation
  - Backup/restore on Standard+
  - SAML SSO and audit logs (Enterprise)
  - Inference API for embeddings + reranking
  sources:
  - https://www.pinecone.io/pricing/
  updated: '2026-05-04'
- type: Glossary
  url: https://docs.pinecone.io/guides/get-started/glossary
- type: Examples
  url: https://docs.pinecone.io/examples/notebooks
- type: Integrations
  url: https://docs.pinecone.io/integrations/overview
- type: ChangeLog
  url: https://docs.pinecone.io/release-notes/2024
- type: StatusPage
  url: https://status.pinecone.io/
- type: Login
  url: https://app.pinecone.io
- type: Security
  url: https://www.pinecone.io/security/
- type: TermsOfService
  url: https://www.pinecone.io/legal/
- type: PrivacyPolicy
  url: https://www.pinecone.io/privacy/
- type: SDKs
  url: https://docs.pinecone.io/reference/pinecone-sdks
- type: Repository
  url: https://github.com/pinecone-io/pinecone-api
- type: LlmsText
  url: https://docs.pinecone.io/llms.txt
integrations:
- name: Agent Skills
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com