Manage projects

View project details, rename projects, add project tags, and delete Pinecone projects using the console or the Admin API with an access token.

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

View project details

You can view the details of a project, as in the following example:

curl

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"

CLI

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:

curl

{
  "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"
}

CLI

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

Rename a project

You can change the name of your project:

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 Project Name.A project name can contain up to 512 characters.
Click Save Changes.

curl

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"
         }'

CLI

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:

curl

{
  "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"
}

CLI

[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 and enter a tag key and value. Repeat for each tag you want to add.
Click Save Changes.

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:

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.

curl

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"

CLI

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