Get started
Claim Deployments
Deployments

However, when transferring a project between two teams owned by the same user, it is recommended to use the Project Transfer flow instead of the Claim Deployments flow.
Claim Deployments
The Claim Deployments feature enables users to take control of deployments by transferring them to their Vercel accounts. Users can generate and share a claim URL, which allows others to assume ownership of these deployments. This feature is particularly helpful for AI-generated deployments and facilitates the transfer of projects between different accounts with different owners.
Associated resources
When a user claims a deployment, Vercel also transfers any associated resources (limited to specific providers) to the new owner's account. These resources maintain their connections to the project, ensuring a seamless transition of both the deployment and its dependencies.
The resource providers that currently support resource transfer are Neon, Supabase, and Prisma.
For more details on the transfer process, see Resources with Claim Deployments flows.
Important endpoints
- Claim Deployments URL: https://vercel.com/claim-deployment?[...]
- Initiate a project transfer request: POST /projects/:idOrName/transfer-request
- Complete a project transfer: PUT /projects/transfer-request/:code This endpoint is not needed if you are using the Claim Deployments URL
Example use case: automated AI-generated deployment
- File upload: The AI agent uploads the deployment files using the Vercel API: POST /v2/files.
- Deployment creation:
- Create a new deployment using the Vercel CLI
- Or create a deployment with the Vercel API: POST /v2/files followed by POST /deployments.
- Project transfer request:
- The agent initiates a transfer request with: POST /projects/:idOrName/transfer-request.
- This returns a code (valid for 24 hours) that allows the agent to transfer the project to another team, typically the end user who initiated the request.
- Generate claim URL:The agent generates a claim URL and shares it with the user: https://vercel.com/claim-deployment?code=xxx&returnUrl=https://xxx
- User claims the deployment:The user accesses the claim page using the URL and selects a team within their Vercel account to transfer the deployment.
- Project transfer completion:After the user clicks Transfer, the Vercel API ( PUT /projects/transfer-request/:code) completes the project transfer, assigning it to the user’s selected team. This step is not necessary if you are using the Claim Deployments Flow.
Team restructuring
Last updated August 21, 2026
Get started with this template of claiming deployments ( demo).
Freelancers or employees can move deployments from their personal accounts to a company’s Vercel account by generating and sharing a claim URL.
Inspect OG Metadata
When reorganizing teams, you can easily transfer ownership of projects to another team using the Claim Deployments feature.
Cross-link map: Claim Deployments (/docs/deployments/claim-deployments)From the Vercel docs graph (built 2026-09-21T05:26:59.511Z), spanning vercel.com docs + KB, nextjs.org, ai-sdk.dev, and other Vercel documentation sites. Full graph as JSON: https://vercel.com/docs/graph.jsonSemantically closest pagesClaim Deployments now available for fast and secure deployment transfersClaim Deployment — A component for users to claim ownership of Vercel deployments created on their behalf.Claimed deployments now include third-party resourcesDeploying to Vercel — Create, verify, and manage preview and production deployments on Vercel from Git, Vercel CLI, or the REST API.Managing Deployments — Learn how to manage your current and previously deployed projects to Vercel through the dashboard. You can redeploy at aThis page links to (7)Deploying Projects from Vercel CLI — Learn how to deploy your Vercel Projects from Vercel CLI using the vercel or vercel deploy commands.Native Integration Flows — Learn how information flows between the integration user, Vercel, and the integration provider for Vercel native integraTransferring a project — Learn how to transfer a project between Vercel teams.Create a new deployment — POST /v13/deployments — Creates a new deployment for the authenticated team or user. For non-git deployments, upload filUpload Deployment Files — POST /v2/files — Before you create a deployment you need to upload the required files for that deployment. To do it, youAccept project transfer request — PUT /projects/transfer-request/{code} — Accept a project transfer request initated by another team.
The \code\\ iCreate project transfer request — POST /projects/{idOrName}/transfer-request — Initiates a project transfer request from one team to another.
ReturnPages that link here (3)By site: vercel-changelog (2) · vercel-docs (1)From vercel-changelogClaim Deployments now available for fast and secure deployment transfersClaimed deployments now include third-party resourcesFrom vercel-docsNative Integration Flows — Learn how information flows between the integration user, Vercel, and the integration provider for Vercel native integra
Was this helpful?