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

:::callout{intent="note"}
You must be an [organization owner](/guides/admin-assistant-organizations-overview#organization-roles) or [project owner](/guides/admin-assistant-projects-overview#project-roles) to edit project details or delete a project.
:::

## View project details

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

:::callout{intent="note"}
An [access token](/guides/admin-assistant-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](/guides/changelog-feature-availability).
:::

:::code-group
```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:

:::code-group
```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
```
:::

:::callout{intent="tip"}
You can view project details using the [Pinecone console](https://app.pinecone.io/organizations/-/settings/projects/-/indexes).
:::

## Rename a project

You can change the name of your project:

:::::tabs
::::tab{title="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 **Project Name**.

   :::callout{intent="note"}
   A project name can contain up to 512 characters.
   :::

4. Click **Save Changes**.
::::

::::tab{title="Code"}
:::callout{intent="note"}
An [access token](/guides/admin-assistant-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](/guides/changelog-feature-availability).
:::

:::code-group
```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:

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

:::callout{intent="tip"}
You can also [add tags to indexes](/guides/manage-data-manage-indexes#configure-index-tags).
:::

## 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/using-pods-back-up-a-pod-based-index#delete-a-collection), [backups](/guides/manage-data-back-up-an-index#delete-a-backup) and [assistants](/guides/build-an-assistant-manage-assistants#delete-an-assistant) associated with the project. Then, you can delete the project itself:

:::::tabs
:::tab{title="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{title="Code"}
:::callout{intent="note"}
An [access token](/guides/admin-assistant-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](/guides/changelog-feature-availability).
:::

:::code-group
```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
```
:::
::::
:::::

## Related pages

- [Understanding projects](./admin-projects-understanding-projects.md)
- [Create a project](./admin-projects-create-a-project.md)
- [Manage projects](./admin-projects-manage-projects.md)
- [Manage project members](./admin-projects-manage-project-members.md)
- [Manage API keys](./admin-projects-manage-api-keys.md)
- [Manage service accounts at the project-level](./admin-projects-manage-service-accounts.md)
- [Projects overview](./admin-assistant-projects-overview.md)
- [Create a project](./admin-assistant-create-a-project.md)
- [Manage project members](./admin-assistant-manage-project-members.md)
- [Manage API keys](./admin-assistant-manage-api-keys.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.