Manage projects

This page shows you how to view project details, rename a project, and delete a project.

You must be an organization owner or project owner to edit project details or delete a project.

View project details

This example retrieves the details of a project:

To complete this action through the Admin API, you need an access token.

PINECONE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"
PROJECT_ID="32c8235a-5220-4a80-a9f1-69c24109e6f2"

curl -X GET "https://api.pinecone.io/admin/projects/$PROJECT_ID" \
     -H "Authorization: Bearer $PINECONE_ACCESS_TOKEN" \
     -H "X-Pinecone-Api-Version: 2026-07" \
     -H "accept: application/json"

PROJECT_ID="32c8235a-5220-4a80-a9f1-69c24109e6f2"

# Target the organization that contains the project.
pc target -o "example-org" 
# Fetch the project details.
pc project describe -i $PROJECT_ID

The example returns a response like the following:

{
  "id": "32c8235a-5220-4a80-a9f1-69c24109e6f2",
  "name": "example-project",
  "max_pods": 5,
  "force_encryption_with_cmek": false,
  "organization_id": "-NM7af6f234168c4e44a",
  "created_at": "2025-10-27T23:27:46.370088Z"
}

ATTRIBUTE           VALUE
Name                example-project
ID                  32c8235a-5220-4a80-a9f1-69c24109e6f2
Organization ID     -NM7af6f234168c4e44a
Created At          2025-10-27 23:27:46.370088 +0000 UTC
Force Encryption    false
Max Pods            5

You can also view project details in the Pinecone console.

Rename a project

Pinecone console
Code

In the Pinecone console, go to Settings > Projects.
Click the ellipsis (…) menu > Configure icon next to the project you want to update.
Enter a new Name.
A project name can contain up to 512 characters.
Click Save changes.

To complete this action through the Admin API, you need an access token.

PROJECT_ID="YOUR_PROJECT_ID"
PINECONE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"

curl -X PATCH "https://api.pinecone.io/admin/projects/$PROJECT_ID" \
     -H "accept: application/json" \
     -H "Content-Type: application/json" \
     -H "X-Pinecone-Api-Version: 2026-07" \
     -d '{
           "name": "updated-example-project"
         }'

PROJECT_ID="YOUR_PROJECT_ID"

# Target the project to update.
pc target -o "example-org" "example-project"
# Update the project name.
pc project update -i $PROJECT_ID -n "updated-example-project"

The example returns a response like the following:

{
  "id": "32c8235a-5220-4a80-a9f1-69c24109e6f2",
  "name": "updated-example-project",
  "max_pods": 5,
  "force_encryption_with_cmek": false,
  "organization_id": "-NM7af6f234168c4e44a",
  "created_at": "2025-10-27T23:27:46.370088Z"
}

[SUCCESS] Project 32c8235a-5220-4a80-a9f1-69c24109e6f2 updated successfully.
ATTRIBUTE           VALUE
Name                updated-example-project
ID                  32c8235a-5220-4a80-a9f1-69c24109e6f2
Organization ID     -NM7af6f234168c4e44a
Created At          2025-10-27 23:27:46.370088 +0000 UTC
Force Encryption    false
Max Pods            5

Add project tags

Project tags are key-value pairs that you can use to categorize and identify a project. To add project tags, use the Pinecone console.

In the Pinecone console, go to Settings > Projects.
Click the ellipsis (…) menu > Configure icon next to the project you want to update.
Click Add tag(s) and enter a tag key and value. Repeat for each tag you want to add.
Click Save changes.

You can also add tags to indexes.

Delete a project

To delete a project, you must first delete all data, indexes, collections, backups, and assistants associated with the project. Then you can delete the project itself.

Pinecone console
Code

In the Pinecone console, go to Settings > Projects.
For the project you want to delete, click the ellipsis (…) menu > Delete.
Enter the project name to confirm the deletion.
Click Delete project.

To complete this action through the Admin API, you need an access token.

PINECONE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"
PROJECT_ID="32c8235a-5220-4a80-a9f1-69c24109e6f2"

curl -X DELETE "https://api.pinecone.io/admin/projects/$PROJECT_ID" \
     -H "X-Pinecone-Api-Version: 2026-07" \
     -H "Authorization: Bearer $PINECONE_ACCESS_TOKEN"

PINECONE_PROJECT_ID="32c8235a-5220-4a80-a9f1-69c24109e6f2"

# Target the organization that contains the project.
pc target -o "example-org" 
# Delete the project. Use --skip-confirmation to skip 
# the confirmation prompt.
pc project delete -i $PINECONE_PROJECT_ID

Organizations

Projects

Billing

Security

Account and support

View project details

Rename a project

Add project tags

Delete a project

​View project details

​Rename a project

​Add project tags

​Delete a project

View project details

Rename a project

Add project tags

Delete a project