How to hit the Pinecone API

Pinecone's control plane at https://api.pinecone.io manages indexes; each index has its own host for reading and writing vectors. Pin the API version with X-Pinecone-Api-Version.

Authentication

Create a key in the Pinecone console and send it as the Api-Key header. In the examples it's written {{PINECONE_API_KEY}}; {{INDEX_HOST}} is an index's host from the list call.

Full reference: https://docs.pinecone.io/reference/api/introduction

List indexes

Each index includes its host.

curl https://api.pinecone.io/indexes \
  -H "Api-Key: {{PINECONE_API_KEY}}" \
  -H "X-Pinecone-Api-Version: 2025-10"
Run in PostTaco

Query an index

curl -X POST https://{{INDEX_HOST}}/query \
  -H "Api-Key: {{PINECONE_API_KEY}}" \
  -H "X-Pinecone-Api-Version: 2025-10" \
  -H "Content-Type: application/json" \
  -d '{"vector": [0.1, 0.2, 0.3], "topK": 3, "includeMetadata": true}'
Run in PostTaco