Pinecone

Overview

Use Pinecone credentials to make authenticated API calls through Alter Vault without exposing API keys in code.

Property	Value
Provider ID	pinecone
Category	AI
Credential Type	API Key

Step 1: Get Credentials

Log in to the Pinecone Console

Log in to the Pinecone Console at app.pinecone.io.

Navigate to API Keys

Select a project and navigate to API Keys.

Create a key

Click Create API Key and name it.

Copy the key

Copy the key — it is only shown once.

Warning

Never share credentials publicly. Store them securely and only enter them in the Alter Vault Developer Portal.

Step 2: Add to Alter Vault

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add Pinecone

Go to Managed Secrets > Add Provider > Pinecone.

Enter credentials

Paste your API Key into the credential field.

Save

Click Save. You’ll receive a grant_id to use with the SDK.

Using in Code

response = await alter_app.request(
    HttpMethod.POST,
    "https://YOUR-INDEX-HOST.pinecone.io/query",
    grant_id="YOUR_GRANT_ID",
    json={"vector": [0.05, 0.61, 0.76, 0.74], "topK": 5, "includeMetadata": True},
)

Notes

• The key is injected via the Api-Key header.
• The same API key authorizes both the control plane (api.pinecone.io) and the index data plane — copy the index’s host from the Pinecone Console and query it directly.

Policy-cataloged operations

Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.

Operation ID	Families	Method	Provider path
list_indexes	read	GET	/indexes
describe_index	read	GET	/indexes/{index_name}
create_index	write	POST	/indexes
create_index_for_model	write	POST	/indexes/create-for-model
create_index_from_backup	write	POST	/backups/{backup_id}/create-index
configure_index	write	PATCH	/indexes/{index_name}
delete_index	delete	DELETE	/indexes/{index_name}
list_collections	read	GET	/collections
describe_collection	read	GET	/collections/{collection_name}
create_collection	write	POST	/collections
delete_collection	delete	DELETE	/collections/{collection_name}
create_backup	write	POST	/indexes/{index_name}/backups
describe_backup	read	GET	/backups/{backup_id}
list_index_backups	read	GET	/indexes/{index_name}/backups
list_project_backups	read	GET	/backups
delete_backup	delete	DELETE	/backups/{backup_id}
describe_restore_job	read	GET	/restore-jobs/{job_id}
list_restore_jobs	read	GET	/restore-jobs
upsertVectors	write	POST	/vectors/upsert
upsertRecordsNamespace	write	POST	/records/namespaces/{namespace}/upsert
updateVector	write	POST	/vectors/update
deleteVectors	delete	POST	/vectors/delete
deleteNamespace	delete	DELETE	/namespaces/{namespace}
queryVectors	read	POST	/query
searchRecordsNamespace	read	POST	/records/namespaces/{namespace}/search
fetchVectors	read	GET	/vectors/fetch
listVectors	read	GET	/vectors/list
listNamespaces	read	GET	/namespaces
describeNamespace	read	GET	/namespaces/{namespace}
describeIndexStats	read	POST	/describe_index_stats