Restores previously archived packages back to active state Moves one or more archived packages back to live (active) state so they can be used again in deployments and SSP publishing.
Request URL https://{server-hostname}:8383/dcapi/swDeployment/package/restoreArchivedPackages
Scope
Header Authorization: d92d4xxxxxxxxxxxxx15f52
Request Parameters - Request Headers Content-Type string Mandatory
- Request Body application/json JSON Object
Hide Sub-Attributes packageIds array Optional
Array of package ID longs to restore. Obtain package IDs from the packageId field in the response of the List Packages API.
Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request POST \
--url https://appdomain/dcapi/swDeployment/package/restoreArchivedPackages \
--header 'Accept: application/PackageRestoreStatus.v1+json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/PackageRestoreStatus.v1+json' \
--data '{"packageIds":[10001]}'import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.net.http.HttpTimeoutException;
public class Main {
public static void main(String[] args) {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://appdomain/dcapi/swDeployment/package/restoreArchivedPackages"))
.header("Content-Type", "application/PackageRestoreStatus.v1+json")
.header("Accept", "application/PackageRestoreStatus.v1+json")
.header("Authorization", " d92d4xxxxxxxxxxxxx15f52")
.method("POST", HttpRequest.BodyPublishers.ofString("{\"packageIds\":[10001]}"))
.build();
HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
import http.client
conn = http.client.HTTPSConnection("appdomain")
payload = "{\"packageIds\":[10001]}"
headers = {
'Content-Type': "application/PackageRestoreStatus.v1+json",
'Accept': "application/PackageRestoreStatus.v1+json",
'Authorization': " d92d4xxxxxxxxxxxxx15f52"
}
conn.request("POST", "/dcapi/swDeployment/package/restoreArchivedPackages", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
headersMap = Map();
headersMap.put("Content-Type", "application/PackageRestoreStatus.v1+json");
headersMap.put("Accept", "application/PackageRestoreStatus.v1+json");
data=Map();
data_packageIds=List();
data.put("packageIds",data_packageIds);
response = invokeUrl
[
url: "https://appDomain/dcapi/swDeployment/package/restoreArchivedPackages"
type: POST
headers: headersMap
body: data
connection: connection_name
]
info response;
$headers=@{}
$headers.Add("Content-Type", "application/PackageRestoreStatus.v1+json")
$headers.Add("Accept", "application/PackageRestoreStatus.v1+json")
$headers.Add("Authorization", " d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomain/dcapi/swDeployment/package/restoreArchivedPackages' -Method POST -Headers $headers -ContentType 'application/PackageRestoreStatus.v1+json' -Body '{"packageIds":[10001]}'Sample Request Body {
"packageIds": [
10001
]
}
▼ Show full
Restore multiple packages
Copied!
{
"packageIds": [
10001,
10002
]
}
▼ Show full
Response Parameters - HTTP code 200 Response Body - application/json - HTTP code 500 Response Body - application/json JSON Object
Hide Sub-Attributes errorCode string
SW_INTERNAL_ERROR for cleanup settings failures, INTERNAL_ERROR for restore operation errors
errorMessage string
Internal server error with details about the cleanup policy or archive restore failure
Possible Response Codes Sample Response: HTTP 200 {
"status": "success"
}
▼ Show full
Sample Response: HTTP 500 {
"errorMessage": "Internal Server Error",
"errorCode": "INTERNAL_ERROR"
}
▼ Show full
Duration: 1 minute | Threshold: 30 | Lock period: 5 minutes
Duration - Time window for the threshold. Threshold - Number of API calls allowed within the specified duration. Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.