Skip to content
Docs

Restore staged project-level redirects to their production version.

POSThttps://api.vercel.com/v1/bulk-redirects/restore
Restores the provided redirects in the staging version to the value in the production version. If no production version exists, removes the redirects from staging.
https://api.vercel.com/v1/bulk-redirects/restore
const response = await fetch('https://api.vercel.com/v1/bulk-redirects/restore?projectId=string&teamId=string&slug=string', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Example Name",
    "redirects": []
  }),
});


const data = await response.json();
console.log(data);
Response
{
  "version": {
    "id": "icfg_1234567890",
    "key": "string",
    "lastModified": "123",
    "createdBy": "string",
    "name": "Example Name",
    "isStaging": "false",
    "isLive": "false",
    "redirectCount": "123",
    "alias": "string"
  },
  "restored": [],
  "failedToRestore": []
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Query parameters

projectIdstringRequired
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
namestringOptional
redirectsarrayRequired
The redirects to restore. The source of the redirect is used to match the redirect to restore.

Response

200Success
versionobjectRequired
restoredarrayRequired
failedToRestorearrayRequired

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
410Error
500Error