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

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

An access token must be provided to complete this action through the Admin API. The Admin API is in public preview.

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: 2025-10" \
     -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 view project details using the Pinecone console.

Rename a project

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

An access token must be provided to complete this action through the Admin API. The Admin API is in public preview.

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: 2025-10" \
     -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 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.

An access token must be provided to complete this action through the Admin API. The Admin API is in public preview.

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: 2025-10" \
     -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

Get started

Index data

Search

Optimize

Manage data

Manage cost

Move to production

Admin

Operations

Using pods

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