Manage projects ↗

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

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

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

```bash
    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
    {
      "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
    [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
    ```

<span class="tab-end"></span>
<span class="tab-group-end"></span>

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

<span class="callout-start" data-callout-type="tip"></span>
You can also [add tags to indexes](/guides/manage-data/manage-indexes#configure-index-tags).
<span class="callout-end"></span>

## Delete a project

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

<span class="tab-group-start"></span>
<span class="tab-start" data-tab-title="Pinecone console"></span>
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**.
<span class="tab-end"></span>

<span class="tab-start" data-tab-title="Code"></span>
<span class="callout-start" data-callout-type="note"></span>
An [access token](/guides/assistant/admin/manage-organization-service-accounts#retrieve-an-access-token) must be provided to complete this action through the Admin API. The Admin API is in [public preview](/assistant-release-notes/feature-availability).
<span class="callout-end"></span>


```bash
    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"
    ```

```bash
    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
    ```

<span class="tab-end"></span>
<span class="tab-group-end"></span>