partner

GET /v1/partner/proven-plugin-releases

The newest version of each of our free plugins that V2 has proven safe.

All partner endpoints

All developer docs →

Zinn®, our Viking, hammering at his anvil beside an API endpoint sending events to several listeners.

Authentication

Send an API key as a bearer token. The key must carry the partner.plugins permission; a key without it is refused with 403, not 404.

This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.

Try it

Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.

curl -X GET https://api.zinndigital.com/v1/partner/proven-plugin-releases \
  -H "Authorization: Bearer zdk_live_…"

Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console

Details

For a partner platform (V1) that rolls our WordPress plugins out through its own checked updater: the newest version of each free plugin (tranzly, page-builder-sandwich, zinn-chat, zinn-footprint) that passed V2's checked update on the staff canary ring — at least one staff or test site KEPT it — and is not halted. A halted version is never listed; a plugin with no proven version is absent. proven_at is the time the first canary site kept it. zip_url is a download on our own API host that needs no credentials: it carries a signed, expiring grant (exp, sig) valid for at least seven days, and changes at most once a day. sha256 is the SHA-256 of exactly the bytes at zip_url — check it before installing. Requires a partner key holding partner.plugins. Rate-limited. Free editions only, except for a FIRST-PARTY partner (our own V1 platform, programme pbn-v1): it also gets tranzly-premium and page-builder-sandwich-premium (edition: licensed), the licensed build of the same Freemius release at the same version as the proven free build. Those rows exist for our own staff product sites, which run the licensed builds. Their zip_url is NOT a bearer grant: it is downloadPartnerLicensedPluginPackage, which needs the same partner key. Halting the free version withdraws the licensed one too.

Response

NameTypeRequiredWhat it is
releasesPartnerProvenPluginRelease[]YesAt most one entry per plugin — its newest proven, unhalted version.

Errors this endpoint can return

401 · 403 · 429