Skip to content
Docs

Create project transfer request

POSThttps://api.vercel.com/projects/{idOrName}/transfer-request
Initiates a project transfer request from one team to another.
Returns a code that remains valid for 24 hours and can be used to accept the transfer request by another team using the PUT /projects/transfer-request/:code endpoint.
Users can also accept the project transfer request using the claim URL: https://vercel.com/claim-deployment?code=<code>&returnUrl=<returnUrl>.
The code parameter specifies the project transfer request code generated using this endpoint.
The returnUrl parameter redirects users to a specific page of the application if the claim URL is invalid or expired.
https://api.vercel.com/projects/{idOrName}/transfer-request
const response = await fetch('https://api.vercel.com/projects/idOrName/transfer-request?teamId=string&slug=string', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "callbackUrl": "https://example.com",
    "callbackSecret": "string"
  }),
});


const data = await response.json();
console.log(data);
Response
{
  "code": "string"
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Path parameters

idOrNamestringRequired
The ID or name of the project to transfer.

Query parameters

teamIdstringOptional
The Team identifier to perform the request on behalf of.
slugstringOptional
The Team slug to perform the request on behalf of.

Body

application/json
callbackUrlstringOptional
The URL to send a webhook to when the transfer is accepted.
callbackSecretstringOptional
The secret to use to sign the webhook payload with HMAC-SHA256.

Response

200The project transfer request has been initiated successfully.
codestringRequired

Errors

400One of the provided values in the request body is invalid. One of the provided values in the request query is invalid.
401The request is not authorized.
403You do not have permission to access this resource.
404Error
409Error
410Error