[metadata]
apple-mobile-web-app-title: Pinecone Docs
application-name: Pinecone Docs
description: Create and manage service accounts at the organization level in Pinecone for programmatic Admin API access, including client secrets and role assignment.
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 and manage service accounts at the organization level in Pinecone for programmatic Admin API access, including client secrets and role assignment.
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 service accounts at the organization-level - Pinecone Docs
og:type: website
og:url: https://docs.pinecone.io/guides/organizations/manage-service-accounts
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/organizations/manage-service-accounts

[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 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
Enterprise plans: https://www.pinecone.io/pricing/
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 cost: /guides/manage-cost/manage-cost
Manage indexes: /guides/manage-data/manage-indexes
Manage members: /guides/organizations/manage-organization-members
Manage namespaces: /guides/manage-data/manage-namespaces
Manage pod-based indexes: /guides/indexes/pods/manage-pod-based-indexes
Manage service accounts at the project-level: /guides/projects/manage-service-accounts
Manage service accounts: /guides/organizations/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
Organization role: /guides/organizations/understanding-organizations#organization-roles
Overview: /guides/get-started/overview
Overview: /guides/index-data/indexing-overview
Overview: /guides/indexes/pods/understanding-pod-based-indexes
Overview: /guides/organizations/understanding-organizations
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
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
Settings > Access > Service accounts: https://app.pinecone.io/organizations/-/settings/access/service-accounts
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
add it to a project: /guides/projects/manage-service-accounts#add-a-service-account-to-a-project
github: https://github.com/pinecone-io
linkedin: https://www.linkedin.com/company/pinecone-io
organization owners: /guides/organizations/understanding-organizations#organization-roles
public preview: /release-notes/feature-availability
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/organizations/manage-service-accounts#webpage","@type":"WebPage","breadcrumb":{"@id":"https://docs.pinecone.io/guides/organizations/manage-service-accounts#breadcrumb"},"dateModified":"2026-08-11T14:29:35.942Z","description":"Create and manage service accounts at the organization level in Pinecone for programmatic Admin API access, including client secrets and role assignment.","isPartOf":{"@id":"https://docs.pinecone.io#website"},"name":"Manage service accounts at the organization-level","url":"https://docs.pinecone.io/guides/organizations/manage-service-accounts"},{"@id":"https://docs.pinecone.io/guides/organizations/manage-service-accounts#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/organizations/understanding-organizations","name":"Manage organizations","position":2},{"@type":"ListItem","item":"https://docs.pinecone.io/guides/organizations/manage-service-accounts","name":"Manage service accounts at the organization-level","position":3}]},{"@id":"https://docs.pinecone.io/guides/organizations/manage-service-accounts#article","@type":["Article","TechArticle"],"dateModified":"2026-08-11T14:29:35.942Z","description":"Create and manage service accounts at the organization level in Pinecone for programmatic Admin API access, including client secrets and role assignment.","headline":"Manage service accounts at the organization-level","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/organizations/manage-service-accounts#webpage"},"name":"Manage service accounts at the organization-level","publisher":{"@id":"https://docs.pinecone.io/#organization"},"url":"https://docs.pinecone.io/guides/organizations/manage-service-accounts"}]}

[content]
Manage service accounts at the organization-level - 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 organizations
Manage service accounts at the organization-level
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
Overview
Manage members
Manage service accounts
Manage projects
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 a service account
Retrieve an access token
Change a service account’s role
Update service account name
Rotate a service account’s secret
Delete a service account
Manage organizations
Manage service accounts at the organization-level
Copy page
Copy page
Create and manage service accounts at the organization level in Pinecone for programmatic Admin API access, including client secrets and role assignment.
Copy page
Copy page
This feature is in
public preview
and available only on
Enterprise plans
.
This page shows how
organization owners
can add and manage service accounts at the organization-level. Service accounts enable programmatic access to Pinecone’s Admin API, which can be used to create and manage projects and API keys.
Once a service account is added at the organization-level, it can be added to a project. For more information, see
Manage service accounts at the project-level
.
​
Create a service account
You can create a service account in the
Pinecone console
:
Go to
Settings > Access > Service accounts
.
Enter a
Name
for the service account.
Choose an
Organization role
for the service account. The role determines the service account’s permissions within Pinecone.
Click
Create
.
Copy and save the
Client secret
in a secure place for future use. You will need the client secret to retrieve an access token.
You will not be able to see the client secret again after you close the dialog.
Click
Close
.
Once you have created a service account,
add it to a project
to allow it access to the project’s resources.
​
Retrieve an access token
To access the Admin API, you must provide an access token to authenticate. Retrieve the access token using the client secret of a service account, which was
provided at time of creation
.
You can retrieve an access token for a service account from the
https://login.pinecone.io/oauth/token
endpoint, as shown in the following example:
curl
curl
"https://login.pinecone.io/oauth/token"
\
#
Note:
Base
URL
is
login.pinecone.io
-H
"X-Pinecone-Api-Version: 2025-10"
\
-H
"Content-Type: application/json"
\
-d
'{
"grant_type": "client_credentials",
"client_id": "YOUR_CLIENT_ID",
"client_secret": "YOUR_CLIENT_SECRET",
"audience": "https://api.pinecone.io/"
}'
The response will include an
access_token
field, which you can use to authenticate with the Admin API.
{
"access_token":"YOUR_ACCESS_TOKEN",
"expires_in":86400,
"token_type":"Bearer"
}
​
Change a service account’s role
You can change a service account’s role in the
Pinecone console
:
Go to
Settings > Access > Service accounts
.
In the row of the service account you want to update, click
ellipsis (…) menu > Manage
.
Select an
Organization role
for the service account.
Click
Update
.
​
Update service account name
You can change a service account’s name in the
Pinecone console
:
Go to
Settings > Access > Service accounts
.
In the row of the service account you want to update, click
ellipsis (…) menu > Manage
.
Enter a new
Service account name
.
Click
Update
.
​
Rotate a service account’s secret
You can rotate a service account’s client secret in the
Pinecone console
:
Go to
Settings > Access > Service accounts
.
In the row of the service account you want to update, click
ellipsis (…) menu > Rotate secret
.
Enter the service account name
to confirm.
Click
Rotate client secret
.
Copy and save the
Client secret
in a secure place for future use.
You will not be able to see the client secret again after you close the dialog.
Click
Close
.
​
Delete a service account
Deleting a service account will remove it from all projects and will disrupt any applications using it to access Pinecone. You delete a service account in the
Pinecone console
:
Go to
Settings > Access > Service accounts
.
In the row of the service account you want to update, click
ellipsis (…) menu > Delete
.
Enter the service account name
to confirm.
Click
Delete service account
.
Was this page helpful?
Yes
No
Manage members
Overview
⌘
I
x
linkedin
youtube
github
Assistant
Responses are generated using AI and may contain mistakes.
