[metadata]
apple-mobile-web-app-title: Pinecone Docs
application-name: Pinecone Docs
description: Create, view, update, and delete Pinecone API keys with custom permissions per project, including scoped roles and data plane access controls.
generator: Mintlify
google-site-verification: woTBImNAcYO-gseVfFKIzQrDRUmLWzFjBWrYbYkOTlI
msapplication-TileColor: #002BFF
msapplication-config: /mintlify-assets/_mintlify/favicons/pinecone/JqxxUxUkDTnX7oN2/_generated/favicon/browserconfig.xml
og:description: Create, view, update, and delete Pinecone API keys with custom permissions per project, including scoped roles and data plane access controls.
og:image: https://www.pinecone.io/images/docs_og_image_v2.png
og:image:height: 630
og:image:width: 1200
og:site_name: Pinecone Docs
og:title: Manage API keys - Pinecone Docs
og:type: website
og:url: https://docs.pinecone.io/guides/projects/manage-api-keys
twitter:card: summary_large_image
twitter:description: Search through billions of items for similar matches to any object, in milliseconds. It's the next generation of search, an API call away.
twitter:image: https://www.pinecone.io/images/docs_og_image_v2.png
twitter:image:height: 630
twitter:image:width: 1200
twitter:title: The vector database to build knowledgeable AI | Pinecone
viewport: width=device-width, initial-scale=1, viewport-fit=cover

[canonical-links]
https://docs.pinecone.io/guides/projects/manage-api-keys

[document-links]
/llms.txt: /llms.txt
Architecture: /guides/get-started/database-architecture
Bring your own cloud (BYOC): /guides/production/bring-your-own-cloud
CI/CD: /guides/production/automated-testing
Choose a pod type: /guides/indexes/pods/choose-a-pod-type-and-size
Concepts: /guides/get-started/concepts
Create a pod-based index: /guides/indexes/pods/create-a-pod-based-index
Create a project: /guides/projects/create-a-project
Create an index: /guides/index-data/create-an-index
Data modeling: /guides/index-data/data-modeling
Decrease latency: /guides/optimize/decrease-latency
Dedicated Read Nodes: /guides/index-data/dedicated-read-nodes
Delete records: /guides/manage-data/delete-data
Error handling: /guides/production/error-handling
Examples: /examples/notebooks
Fetch records: /guides/manage-data/fetch-data
Filter by metadata: /guides/search/filter-by-metadata
Full-text search: /guides/search/full-text-search
Guides: /guides/get-started/overview
Hybrid search: /guides/search/hybrid-search
IDEs & CLIs: /guides/get-started/ai-coding-tools
Implement multitenancy: /guides/index-data/implement-multitenancy
Increase relevance: /guides/optimize/increase-relevance
Increase throughput: /guides/optimize/increase-throughput
Integrations: /integrations/overview
Lexical search: /guides/search/lexical-search
List record IDs: /guides/manage-data/list-record-ids
Local development: /guides/operations/local-development
Log In: https://app.pinecone.io/?sessionType=login
Manage API keys: /guides/projects/manage-api-keys
Manage cost: /guides/manage-cost/manage-cost
Manage indexes: /guides/manage-data/manage-indexes
Manage namespaces: /guides/manage-data/manage-namespaces
Manage pod-based indexes: /guides/indexes/pods/manage-pod-based-indexes
Manage project members: /guides/projects/manage-project-members
Manage projects: /guides/projects/manage-projects
Manage service accounts: /guides/projects/manage-service-accounts
Migrate a pod-based index to serverless: /guides/indexes/pods/migrate-a-pod-based-index-to-serverless
Models: /models/overview
Monitor performance: /guides/production/monitoring
Monitor usage and costs: /guides/manage-cost/monitor-usage-and-costs
Overview: /guides/get-started/overview
Overview: /guides/index-data/indexing-overview
Overview: /guides/indexes/pods/understanding-pod-based-indexes
Overview: /guides/production/production-checklist
Overview: /guides/projects/understanding-projects
Overview: /guides/search/search-overview
Pinecone Docs home page: https://www.pinecone.io
Pinecone console: https://app.pinecone.io/organizations/-/projects
Project roles: /guides/projects/understanding-projects#project-roles
Quickstart: /guides/get-started/quickstart
Reciprocal rank fusion: /guides/search/reciprocal-rank-fusion
Reference: /reference/api/introduction
Releases: /release-notes/2026
Rerank results: /guides/search/rerank-results
Save on costs: /guides/optimize/save-on-costs
Scale pod-based indexes: /guides/indexes/pods/scale-pod-based-indexes
See details: /guides/manage-cost/understanding-cost#imports
Semantic search: /guides/search/semantic-search
Sign up free: https://app.pinecone.io/?sessionType=signup
Status: https://status.pinecone.io
Support: https://app.pinecone.io/organizations/-/settings/support
Target an index: /guides/manage-data/target-an-index
Test at scale: /guides/get-started/test-at-scale
Troubleshooting: /troubleshooting/contact-support
Understanding cost: /guides/manage-cost/understanding-cost
Update records: /guides/manage-data/update-data
access token: /guides/organizations/manage-service-accounts#retrieve-an-access-token
github: https://github.com/pinecone-io
linkedin: https://www.linkedin.com/company/pinecone-io
make calls to the Pinecone API: /guides/get-started/quickstart
project owner: /guides/projects/understanding-projects#project-roles
project: /guides/projects/understanding-projects
target your index by host: /guides/manage-data/target-an-index#target-by-index-host-recommended
upgrade to the Standard or Enterprise plan: /guides/organizations/manage-billing/upgrade-billing-plan
view the API keys: /reference/api/latest/admin/list_api_keys
view the details of an API key: /reference/api/latest/admin/fetch_api_key
x: https://x.com/pinecone?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Eauthor
youtube: https://www.youtube.com/@pinecone-io

[structured-data]
{"@context":"https://schema.org","@graph":[{"@id":"https://docs.pinecone.io/#organization","@type":"Organization","logo":{"@type":"ImageObject","url":"https://mintcdn.com/pinecone/HsZKO51bNmpAasdT/logo/Pinecone-Full-Logo-Black.svg?fit=max&auto=format&n=HsZKO51bNmpAasdT&q=85&s=211d0e7bbefc29ce3b8feee1a05d76ee"},"name":"Pinecone Docs","url":"https://docs.pinecone.io"},{"@id":"https://docs.pinecone.io#website","@type":"WebSite","name":"Pinecone Docs","publisher":{"@id":"https://docs.pinecone.io/#organization"},"url":"https://docs.pinecone.io"},{"@id":"https://docs.pinecone.io/guides/projects/manage-api-keys#webpage","@type":"WebPage","breadcrumb":{"@id":"https://docs.pinecone.io/guides/projects/manage-api-keys#breadcrumb"},"dateModified":"2026-08-11T14:29:35.923Z","description":"Create, view, update, and delete Pinecone API keys with custom permissions per project, including scoped roles and data plane access controls.","isPartOf":{"@id":"https://docs.pinecone.io#website"},"name":"Manage API keys","url":"https://docs.pinecone.io/guides/projects/manage-api-keys"},{"@id":"https://docs.pinecone.io/guides/projects/manage-api-keys#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://docs.pinecone.io/guides/organizations/manage-billing/upgrade-billing-plan","name":"Admin","position":1},{"@type":"ListItem","item":"https://docs.pinecone.io/guides/projects/understanding-projects","name":"Manage projects","position":2},{"@type":"ListItem","item":"https://docs.pinecone.io/guides/projects/manage-api-keys","name":"Manage API keys","position":3}]},{"@id":"https://docs.pinecone.io/guides/projects/manage-api-keys#article","@type":["Article","TechArticle"],"dateModified":"2026-08-11T14:29:35.923Z","description":"Create, view, update, and delete Pinecone API keys with custom permissions per project, including scoped roles and data plane access controls.","headline":"Manage API keys","image":"https://www.pinecone.io/images/docs_og_image_v2.png","isPartOf":{"@id":"https://docs.pinecone.io#website"},"mainEntityOfPage":{"@id":"https://docs.pinecone.io/guides/projects/manage-api-keys#webpage"},"name":"Manage API keys","publisher":{"@id":"https://docs.pinecone.io/#organization"},"url":"https://docs.pinecone.io/guides/projects/manage-api-keys"}]}

[content]
Manage API keys - Pinecone Docs
Documentation Index
Fetch the complete documentation index at:
/llms.txt
Use this file to discover all available pages before exploring further.
Skip to main content
🎉 New: Standard and Enterprise orgs get a one-time
$250 bulk import credit
(1 TB), valid through August 30, 2026.
See details
Pinecone Docs
home page
Search...
⌘
K
Ask Assistant
Status
Support
Log In
Sign up free
Sign up free
Search...
Navigation
Manage projects
Manage API keys
Guides
Reference
Examples
Models
Integrations
Troubleshooting
Releases
Pinecone Database
Get started
Overview
Quickstart
IDEs & CLIs
Test at scale
Concepts
Architecture
Index data
Overview
Create an index
Data modeling
Data ingestion
Implement multitenancy
Dedicated Read Nodes
Search
Overview
Full-text search
Semantic search
Lexical search
Hybrid search
Reciprocal rank fusion
Filter by metadata
Rerank results
Optimize
Increase relevance
Increase throughput
Decrease latency
Save on costs
Manage data
Target an index
Manage indexes
Manage namespaces
Manage backups
Update records
Delete records
Fetch records
List record IDs
Manage cost
Understanding cost
Manage cost
Monitor usage and costs
Move to production
Overview
Bring your own cloud (BYOC)
Enforce security
Error handling
Monitor performance
CI/CD
Admin
Manage billing
Manage organizations
Manage projects
Overview
Create a project
Manage projects
Manage project members
Manage API keys
Manage service accounts
Operations
Integrate with cloud storage
Integrate with AI agents
Local development
Using pods
Overview
Migrate a pod-based index to serverless
Choose a pod type
Create a pod-based index
Manage pod-based indexes
Scale pod-based indexes
Back up and restore
On this page
Create an API key
View project API keys
View API key details
Update an API key
Delete an API key
Manage projects
Manage API keys
Copy page
Copy page
Create, view, update, and delete Pinecone API keys with custom permissions per project, including scoped roles and data plane access controls.
Copy page
Copy page
Each Pinecone
project
has one or more API keys. In order to
make calls to the Pinecone API
, you must provide a valid API key for the relevant Pinecone project.
This page shows you how to
create
,
view
,
update
, and
delete
API keys.
If you use custom API key permissions, ensure that you
target your index by host
when performing data operations such as
upsert
and
query
.
​
Create an API key
You can create a new API key for your project, as follows:
Pinecone console
Code
Open the
Pinecone console
.
Select your project.
Go to
API keys
.
Click
Create API key
.
Enter an
API key name
.
Select the
Permissions
to grant to the API key. For a description of the permission roles, see
Project roles
.
Users on the Starter and Builder plans can set the permissions to
All
only. To customize the permissions further,
upgrade to the Standard or Enterprise plan
.
Click
Create key
.
Copy and save the generated API key in a secure place for future use.
You will not be able to see the API key again after you close the dialog.
Click
Close
.
An
access token
must be provided to complete this action through the Admin API.
curl
CLI
PINECONE_PROJECT_ID
=
"YOUR_PROJECT_ID"
PINECONE_ACCESS_TOKEN
=
"YOUR_ACCESS_TOKEN"
curl
-X
POST
"https://api.pinecone.io/admin/projects/
$PINECONE_PROJECT_ID
/api-keys"
\
-H
"X-Pinecone-Api-Version: 2025-10"
\
-H
"Authorization: Bearer
$PINECONE_ACCESS_TOKEN
"
\
-d
'{
"name": "example-api-key",
"roles": ["ProjectEditor"]
}'
# Target the project for which you want to create an API key.
pc
target
-o
"example-org"
-p
"example-project"
# Create the API key
pc
api-key
create
-n
"example-api-key"
--roles
ProjectEditor
The example returns a response like the following:
curl
CLI
{
"key"
: {
"id"
:
"62b0dbfe-3489-4b79-b850-34d911527c88"
,
"name"
:
"example-api-key"
,
"project_id"
:
"32c8235a-5220-4a80-a9f1-69c24109e6f2"
,
"roles"
: [
"ProjectEditor"
],
"created_at"
:
"2025-10-20T23:40:27.069075Z"
},
"value"
:
"..."
}
ATTRIBUTE VALUE
Name example-api-key
ID 62b0dbfe-3489-4b79-b850-34d911527c88
Value ...
Project ID 32c8235a-5220-4a80-a9f1-69c24109e6f2
Roles ProjectEditor
​
View project API keys
You can
view the API keys
for your project:
Pinecone console
Code
Open the
Pinecone console
.
Select your project.
Go to the
API keys
tab.
You will see a list of all API keys for the project, including their names, IDs, and permissions.
An
access token
must be provided to complete this action through the Admin API.
curl
CLI
PINECONE_PROJECT_ID
=
"32c8235a-5220-4a80-a9f1-69c24109e6f2"
PINECONE_ACCESS_TOKEN
=
"YOUR_ACCESS_TOKEN"
curl
-X
GET
"https://api.pinecone.io/admin/projects/
$PINECONE_PROJECT_ID
/api-keys"
\
-H
"Authorization: Bearer
$PINECONE_ACCESS_TOKEN
"
\
-H
"X-Pinecone-Api-Version: 2025-10"
PINECONE_PROJECT_ID
=
"32c8235a-5220-4a80-a9f1-69c24109e6f2"
pc
api-key
list
-i
$PINECONE_PROJECT_ID
The example returns a response like the following:
curl
CLI
{
"data"
: [
{
"id"
:
"62b0dbfe-3489-4b79-b850-34d911527c88"
,
"name"
:
"example-api-key"
,
"project_id"
:
"32c8235a-5220-4a80-a9f1-69c24109e6f2"
,
"roles"
: [
"ProjectEditor"
],
"created_at"
:
"2025-10-20T23:39:43.665754Z"
},
{
"id"
:
"0d0d3678-81b4-4e0d-a4f0-70ba488acfb7"
,
"name"
:
"example-api-key-2"
,
"project_id"
:
"32c8235a-5220-4a80-a9f1-69c24109e6f2"
,
"roles"
: [
"ProjectEditor"
],
"created_at"
:
"2025-10-20T23:43:13.176422Z"
}
]
}
Organization: example-organization (ID: -NM7af6f234168c4e44a)
Project: example-project (ID: 32c8235a-5220-4a80-a9f1-69c24109e6f2)
API Keys
NAME ID PROJECT ID ROLES
example-api-key 62b0dbfe-3489-4b79-b850-34d911527c88 32c8235a-5220-4a80-a9f1-69c24109e6f2 ProjectEditor
example-api-key-2 0d0d3678-81b4-4e0d-a4f0-70ba488acfb7 32c8235a-5220-4a80-a9f1-69c24109e6f2 ProjectEditor
​
View API key details
You can
view the details of an API key
:
Pinecone console
Code
Open the
Pinecone console
.
Select your project.
Go to the
API keys
tab.
In the row of the API key you want to change, in the
Actions
column, click
ellipsis (…) menu > Settings
.
You will see the API key’s name, ID, and permissions.
An
access token
must be provided to complete this action through the Admin API.
curl
CLI
PINECONE_API_KEY_ID
=
"62b0dbfe-3489-4b79-b850-34d911527c88"
PINECONE_ACCESS_TOKEN
=
"YOUR_ACCESS_TOKEN"
curl
-X
GET
"https://api.pinecone.io/admin/api-keys/
$PINECONE_API_KEY_ID
"
\
-H
"Authorization: Bearer
$PINECONE_ACCESS_TOKEN
"
\
-H
"accept: application/json"
\
-H
"X-Pinecone-Api-Version: 2025-10"
PINECONE_API_KEY_ID
=
"62b0dbfe-3489-4b79-b850-34d911527c88"
pc
api-key
describe
-i
$PINECONE_API_KEY_ID
The example returns a response like the following:
curl
CLI
{
"id"
:
"62b0dbfe-3489-4b79-b850-34d911527c88"
,
"name"
:
"example-api-key"
,
"project_id"
:
"32c8235a-5220-4a80-a9f1-69c24109e6f2"
,
"roles"
: [
"ProjectEditor"
],
"created_at"
:
"2025-10-22T19:27:21.202955Z"
}
ATTRIBUTE VALUE
Name example-api-key
ID 62b0dbfe-3489-4b79-b850-34d911527c88
Project ID 32c8235a-5220-4a80-a9f1-69c24109e6f2
Roles ProjectEditor
​
Update an API key
Users on the Starter and Builder plans cannot change API key permissions once they are set. Instead,
create a new API key
or
upgrade to the Standard or Enterprise plan
.
If you are a
project owner
, you can update the name and roles of an API key:
Pinecone console
Code
Open the
Pinecone console
.
Select your project.
Go to the
API keys
tab.
In the row of the API key you want to change, in the
Actions
column, click
ellipsis (…) menu > Settings
.
Change the name and/or permissions for the API key as needed.
For information about the different API key permissions, refer to
Project roles
.
Click
Update
.
An
access token
must be provided to complete this action through the Admin API.
curl
CLI
PINECONE_API_KEY_ID
=
"62b0dbfe-3489-4b79-b850-34d911527c88"
PINECONE_ACCESS_TOKEN
=
"YOUR_ACCESS_TOKEN"
curl
-X
PATCH
"https://api.pinecone.io/admin/api-keys/
$PINECONE_API_KEY_ID
"
\
-H
"X-Pinecone-Api-Version: 2025-10"
\
-H
"Authorization: Bearer
$PINECONE_ACCESS_TOKEN
"
\
-d
'{
"name": "new-api-key-name",
"roles": ["ProjectEditor"]
}'
PINECONE_API_KEY_ID
=
"62b0dbfe-3489-4b79-b850-34d911527c88"
# Target the organization that contains the API key.
pc
target
-o
"example-org"
# Update the API key name.
pc
api-key
update
-i
$PINECONE_API_KEY_ID
-n
"new-api-key-name"
The example returns a response like the following:
curl
CLI
{
"id"
:
"62b0dbfe-3489-4b79-b850-34d911527c88"
,
"name"
:
"new-api-key-name"
,
"project_id"
:
"32c8235a-5220-4a80-a9f1-69c24109e6f2"
,
"roles"
: [
"ProjectEditor"
],
"created_at"
:
"2025-10-22T19:27:21.202955Z"
}
ATTRIBUTE VALUE
Name new-api-key-name
ID 62b0dbfe-3489-4b79-b850-34d911527c88
Project ID 32c8235a-5220-4a80-a9f1-69c24109e6f2
Roles ProjectEditor
​
Delete an API key
If you are a
project owner
, you can delete your API key:
Pinecone console
Code
Open the
Pinecone console
.
Select your project.
Go to the
API keys
tab.
In the row of the API key you want to change, in the
Actions
column, click
ellipsis (…) menu > Delete
.
Enter the
API key name
.
Click
Confirm deletion
.
Deleting an API key is irreversible and will immediately disable any applications using the API key.
An
access token
must be provided to complete this action through the Admin API.
curl
CLI
PINECONE_API_KEY_ID
=
"62b0dbfe-3489-4b79-b850-34d911527c88"
PINECONE_ACCESS_TOKEN
=
"YOUR_ACCESS_TOKEN"
curl
-X
DELETE
"https://api.pinecone.io/admin/api-keys/
$PINECONE_API_KEY_ID
"
\
-H
"X-Pinecone-Api-Version: 2025-10"
\
-H
"Authorization: Bearer
$PINECONE_ACCESS_TOKEN
"
PINECONE_API_KEY_ID
=
"62b0dbfe-3489-4b79-b850-34d911527c88"
# Delete the API key. Use --skip-confirmation to skip
# the confirmation prompt.
pc
api-key
delete
-i
$PINECONE_API_KEY_ID
The example returns a response like the following:
curl
CLI
No response payload
[WARN] This operation will delete API key example-api-key from project example-project.
[WARN] Any integrations that authenticate with this API key will immediately stop working.
[WARN] This action cannot be undone.
Do you want to continue? (y/N): y
[INFO] You chose to continue delete.
[SUCCESS] API key example-api-key deleted
Was this page helpful?
Yes
No
Manage project members
Manage service accounts
⌘
I
x
linkedin
youtube
github
Assistant
Responses are generated using AI and may contain mistakes.
