> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinecone.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage projects

> View project details, rename projects, and delete projects in your Pinecone organization using the console or Admin API with owner permissions.

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

> [!NOTE]
>
> You must be an [organization owner](https://docs.pinecone.io/admin/organizations/organizations-overview.md#organization-roles) or [project owner](https://docs.pinecone.io/admin/projects/projects-overview.md#project-roles) to edit project details or delete a project.

## View project details

This example retrieves the details of a project:

> [!NOTE]
>
> To complete this action through the Admin API, you need an [access token](https://docs.pinecone.io/admin/organizations/manage-service-accounts.md#retrieve-an-access-token).

```bash curl theme={null}
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"
```

```bash CLI theme={null}
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:

```json curl theme={null}
{
  "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"
}
```

```text CLI theme={null}
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
```

> [!TIP]
>
> You can also view project details in the [Pinecone console](https://app.pinecone.io/organizations/-/projects).

## Rename a project

> [tab] Pinecone console
>
> 1. In the Pinecone console, go to [**Settings > Projects**](https://app.pinecone.io/organizations/-/settings/projects).
>
> 2. Click the **ellipsis (...) menu > Configure** icon next to the project you want to update.
>
> 3. Enter a new **Name**.
>
>    > [!NOTE]
>    >
>    > A project name can contain up to 512 characters.
>
> 4. Click **Save changes**.

> [tab] Code
>
> > [!NOTE]
> >
> > To complete this action through the Admin API, you need an [access token](https://docs.pinecone.io/admin/organizations/manage-service-accounts.md#retrieve-an-access-token).
>
> ```bash curl theme={null}
> 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"
>          }'
> ```
>
> ```bash CLI theme={null}
> 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:
>
> ```json curl theme={null}
> {
>   "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"
> }
> ```
>
> ```text CLI theme={null}
> [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.

1. In the Pinecone console, go to [**Settings > Projects**](https://app.pinecone.io/organizations/-/settings/projects).
2. Click the **ellipsis (...) menu > Configure** icon next to the project you want to update.
3. Click **Add tag(s)** and enter a tag key and value. Repeat for each tag you want to add.
4. Click **Save changes**.

> [!TIP]
>
> You can also [add tags to indexes](https://docs.pinecone.io/guides/indexes/manage-indexes.md#configure-index-tags).

## Delete a project

To delete a project, you must first [delete all data](https://docs.pinecone.io/guides/data/delete-data.md), [indexes](https://docs.pinecone.io/guides/indexes/manage-indexes.md#delete-an-index), [collections](https://docs.pinecone.io/guides/legacy/pod-based-indexes/back-up-a-pod-based-index.md#delete-a-collection), [backups](https://docs.pinecone.io/guides/indexes/back-up-an-index.md#delete-a-backup), and [assistants](https://docs.pinecone.io/guides/assistant/manage-assistants.md#delete-an-assistant) associated with the project. Then you can delete the project itself.

> [tab] Pinecone console
>
> 1. In the Pinecone console, go to [**Settings > Projects**](https://app.pinecone.io/organizations/-/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**.

> [tab] Code
>
> > [!NOTE]
> >
> > To complete this action through the Admin API, you need an [access token](https://docs.pinecone.io/admin/organizations/manage-service-accounts.md#retrieve-an-access-token).
>
> ```bash curl theme={null}
> 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"
> ```
>
> ```bash CLI theme={null}
> 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
> ```
