This page shows you how to rename a project, set a project pod limit, 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.

curl
PINECONE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"
PROJECT_ID="3fa85f64-5717-4562-b3fc-2c963f66afa6"

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

The example returns a response like the following:

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "example-project",
  "max_pods": 0,
  "force_encryption_with_cmek": false,
  "organization_id": "string",
  "created_at": "2025-03-17T00:30:23.262Z"
}

You can view project details using the Pinecone console.

​
Rename a project

You can change the name of your project:

  1. In the Pinecone console, got to Settings > Projects.

  2. Click the ellipsis (…) menu > Configure icon next to the project you want to update.

  3. Enter a new Project Name.

    A project name can contain up to 512 characters. For more information, see Identifier limits.

  4. Click Save Changes.

​
Set a project pod limit

Pod limits do not apply to serverless indexes. Pinecone auto-scales serverless indexes based on usage, and you pay only for what you use.

You can set or change the default limit on the number of pods per project for organizations on Standard and Enterprise plans:

  1. Go to Settings > Projects.
  2. For the project you want to update, click the ellipsis (…) menu > Configure.
  3. In the Pod Limit section, update the number of pods.
  4. 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:

  1. In the Pinecone console, got to Settings > Projects.
  2. For the project you want to delete, click the ellipsis (…) menu > Delete.
  3. Enter the project name to confirm the deletion.
  4. Click Delete Project.