Download Release

Download a release ZIP file. Validates the license before serving and tracks download count.

GET /v1/download/:releaseId

Path Parameters

Parameter	Required	Description
releaseId	Yes	Release ID

Query Parameters

Parameter	Required	Description
license_key	Yes	License key for download access
site	No	The site URL. When supplied, a site whose activation has been deactivated is refused even with a valid key.

Response

Streams the release ZIP file from R2 storage:

Content-Type: application/zip
Content-Disposition: attachment; filename="my-plugin-1.0.0.zip"

Example

curl -O "https://api.packedge.dev/v1/download/rel_xxx?license_key=MYPLUGIN-XXXX-XXXX-XXXX-XXXX"

Notes

• License is validated before serving the file
• Download count is automatically tracked
• File is streamed directly from Cloudflare R2 storage
• Invalid or expired licenses receive a 403 response
• A deactivated site is refused even with a valid license key, so a copied download URL stops working once that site is deactivated

Errors

Status	Description
403	Invalid or expired license, or the site is deactivated
404	Release not found

Usage

This endpoint is typically called by WordPress during plugin updates. The URL is provided in the package field of the update check response.

You generally don't need to call this directly — WordPress handles it automatically when the user clicks "Update" in the admin.