Claim Deployments

The Claim Deployments feature allows users to take ownership of deployments by transferring them to their Vercel accounts. With this feature, users can generate and share a claim URL, making it easy for others to take ownership of deployments. It's particularly useful for AI-generated deployments and simplifies project transfers.

• 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

1. File upload: The AI agent uploads the deployment files using the Vercel API: POST /files.

2. Deployment creation:

   • Create a new deployment using the Vercel CLI
   • Or create a deployment with the Vercel API: POST /files followed by POST /deployments.

3. 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.

4. 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

5. 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.

6. 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.

When reorganizing teams, you can easily transfer ownership of projects to another team using the Claim Deployments feature.

Freelancers or employees can move deployments from their personal accounts to a company’s Vercel account by generating and sharing a claim URL.