---
title: projects
product: vercel
url: /docs/rest-api/projects
canonical_url: "https://vercel.com/docs/rest-api/projects"
last_updated: 2026-07-23
type: reference
prerequisites:
  []
related:
  - /docs/rest-api/projects/retrieve-a-list-of-projects.md
  - /docs/rest-api/projects/get-a-project-trace-by-request-id.md
  - /docs/rest-api/projects/create-a-new-project.md
  - /docs/rest-api/projects/generate-a-project-oidc-token.md
  - /docs/rest-api/projects/create-a-trace-session-token-for-a-deployment.md
summary: Learn about projects on Vercel.
install_vercel_plugin: npx plugins add vercel/vercel-plugin
---

# projects

Endpoints in the projects group of the Vercel REST API Reference.

| Method | Endpoint | Description |
|---|---|---|
| **GET** | [`/v10/projects`](/docs/rest-api/projects/retrieve-a-list-of-projects.md) | Retrieve a list of projects |
| **GET** | [`/v1/projects/traces`](/docs/rest-api/projects/get-a-project-trace-by-request-id.md) | Get a project trace by request ID |
| **POST** | [`/v11/projects`](/docs/rest-api/projects/create-a-new-project.md) | Create a new project |
| **POST** | [`/v1/projects/{idOrName}/token`](/docs/rest-api/projects/generate-a-project-oidc-token.md) | Generate a project OIDC token |
| **POST** | [`/v1/projects/traces/session`](/docs/rest-api/projects/create-a-trace-session-token-for-a-deployment.md) | Create a trace session token for a deployment |
| **GET** | [`/v9/projects/{idOrName}`](/docs/rest-api/projects/find-a-project-by-id-or-name.md) | Find a project by id or name |
| **PATCH** | [`/v9/projects/{idOrName}`](/docs/rest-api/projects/update-an-existing-project.md) | Update an existing project |
| **DELETE** | [`/v9/projects/{idOrName}`](/docs/rest-api/projects/delete-a-project.md) | Delete a Project |
| **POST** | [`/v1/projects/{idOrName}/avatar`](/docs/rest-api/projects/upload-a-project-avatar.md) | Upload a project avatar |
| **GET** | [`/v9/projects/{idOrName}/domains`](/docs/rest-api/projects/retrieve-project-domains-by-project-by-id-or-name.md) | Retrieve project domains by project by id or name |
| **GET** | [`/v9/projects/{idOrName}/domains/{domain}`](/docs/rest-api/projects/get-a-project-domain.md) | Get a project domain |
| **PATCH** | [`/v9/projects/{idOrName}/domains/{domain}`](/docs/rest-api/projects/update-a-project-domain.md) | Update a project domain |
| **DELETE** | [`/v9/projects/{idOrName}/domains/{domain}`](/docs/rest-api/projects/remove-a-domain-from-a-project.md) | Remove a domain from a project |
| **POST** | [`/v10/projects/{idOrName}/domains`](/docs/rest-api/projects/add-a-domain-to-a-project.md) | Add a domain to a project |
| **POST** | [`/v1/projects/{idOrName}/domains/{domain}/move`](/docs/rest-api/projects/move-a-project-domain.md) | Move a project domain |
| **POST** | [`/v9/projects/{idOrName}/domains/{domain}/verify`](/docs/rest-api/projects/verify-project-domain.md) | Verify project domain |
| **GET** | [`/v10/projects/{idOrName}/env`](/docs/rest-api/projects/retrieve-the-environment-variables-of-a-project-by-id-or-name.md) | Retrieve the environment variables of a project by id or name |
| **POST** | [`/v10/projects/{idOrName}/env`](/docs/rest-api/projects/create-one-or-more-environment-variables.md) | Create one or more environment variables |
| **GET** | [`/v1/projects/{idOrName}/env/{id}`](/docs/rest-api/projects/retrieve-the-decrypted-value-of-an-environment-variable-of-a-project-by-id.md) | Retrieve the decrypted value of an environment variable of a project by id |
| **PATCH** | [`/v9/projects/{idOrName}/env/{id}`](/docs/rest-api/projects/edit-an-environment-variable.md) | Edit an environment variable |
| **DELETE** | [`/v9/projects/{idOrName}/env/{id}`](/docs/rest-api/projects/remove-an-environment-variable.md) | Remove an environment variable |
| **DELETE** | [`/v1/projects/{idOrName}/env`](/docs/rest-api/projects/batch-remove-environment-variables.md) | Batch remove environment variables |
| **POST** | [`/projects/{idOrName}/transfer-request`](/docs/rest-api/projects/create-project-transfer-request.md) | Create project transfer request |
| **PUT** | [`/projects/transfer-request/{code}`](/docs/rest-api/projects/accept-project-transfer-request.md) | Accept project transfer request |
| **PATCH** | [`/v1/projects/{idOrName}/protection-bypass`](/docs/rest-api/projects/update-protection-bypass-for-automation.md) | Update Protection Bypass for Automation |
| **POST** | [`/v1/projects/{projectId}/rollback/{deploymentId}`](/docs/rest-api/projects/point-production-traffic-to-a-previous-production-deployment-by-id.md) | Point production traffic to a previous production deployment by ID |
| **PATCH** | [`/v1/projects/{projectId}/rollback/{deploymentId}/update-description`](/docs/rest-api/projects/updates-the-description-for-a-rollback.md) | Updates the description for a rollback |
| **PATCH** | [`/v1/projects/{projectId}/microfrontends`](/docs/rest-api/projects/update-the-microfrontends-settings.md) | Update the microfrontends settings |
| **POST** | [`/v10/projects/{projectId}/promote/{deploymentId}`](/docs/rest-api/projects/point-production-traffic-to-a-given-deployment.md) | Point production traffic to a given deployment |
| **GET** | [`/v1/projects/{projectId}/promote/aliases`](/docs/rest-api/projects/gets-a-list-of-aliases-with-status-for-the-current-promote.md) | Gets a list of aliases with status for the current promote |
| **POST** | [`/v1/projects/{projectId}/pause`](/docs/rest-api/projects/pause-a-project.md) | Pause a project |
| **POST** | [`/v1/projects/{projectId}/unpause`](/docs/rest-api/projects/unpause-a-project.md) | Unpause a project |

---

## Related

- [REST API overview](/docs/rest-api)

---

[View full sitemap](/docs/sitemap)