List public CloudPrint Agent releases
List current CloudPrint Agent installers published by CloudPrint and their checksums without requiring CloudPrint credentials.
GET
/agent-download-api/v1/releasesAPI version: v1operationId: listPublicAgentReleasesView as MarkdownWhat this endpoint does
List current CloudPrint Agent installers published by CloudPrint and their checksums without requiring CloudPrint credentials.
Authentication
This endpoint does not require a Bearer token.
Request
Production base URL: https://public-api.cloudprint.me/agent-download-api/v1/releases
Parameters
| Name | Location | Type | Required | Description | Constraints |
|---|---|---|---|---|---|
X-Request-Id | header | string | no | Optional request identifier for tracing; CloudPrint returns a safe value in the response header. | maxLength: 128; example: "order-100045-attempt-1" |
Request body
This endpoint has no request body.
Example requests
cURL
bash
curl -sS https://public-api.cloudprint.me/agent-download-api/v1/releasesResponse
HTTP status: 200 — Public Agent release catalog
Response fields
| Name | Type | Required | Description | Constraints |
|---|---|---|---|---|
available | boolean | yes | Whether a published installer is currently available for the requested platform. | — |
channel | string | null | yes | Release channel to which this Agent build belongs. | — |
releases | array | yes | Published Agent installers grouped by supported platform. | — |
unavailable_reason | string | null | no | Reason no published installer is available for this platform. | — |
Example response
json
{
"available": true,
"channel": "string",
"releases": [
{
"version": "string",
"channel": "string",
"published_at": "2026-08-06T12:00:00Z",
"installers": [
{
"filename": "string",
"platform": "macos",
"architecture": "string",
"format": "string",
"size_bytes": 1,
"sha256": "0000000000000000000000000000000000000000000000000000000000000000",
"download_url": "/resource"
}
]
}
]
}Errors
| HTTP status | Description |
|---|---|
429 | Rate limit exceeded |
500 | Unexpected error |
503 | Agent release catalog is unavailable |
Related documentation
Download a CloudPrint Agent installerDownload one published CloudPrint Agent installer by the exact filename returned by the release catalog.Set up an Agent for a managed accountCreate a one-time setup link and connect CloudPrint Agent to the correct customer account without a portal login.Local Printer API for web and SaaS applicationsConnect a web or SaaS backend to local printers through CloudPrint Agent, discover printer queues via API and route jobs by stable printer ID.