---
title: "Listar versiones públicas de CloudPrint Agent"
description: "Consulta los instaladores actuales de CloudPrint Agent y sus sumas de comprobación sin credenciales de CloudPrint."
---
# Listar versiones públicas de CloudPrint Agent
Consulta los instaladores actuales de CloudPrint Agent y sus sumas de comprobación sin credenciales de CloudPrint.
GET/agent-download-api/v1/releasesVersión de la API: v1operationId:listPublicAgentReleasesVer como Markdown
## Qué hace este método
Consulta los instaladores actuales de CloudPrint Agent y sus sumas de comprobación sin credenciales de CloudPrint.
## Autenticación
Este método no requiere un token Bearer.
## Solicitud
**URL de producción:** `https://public-api.cloudprint.me/agent-download-api/v1/releases`
### Parámetros
| Nombre | Ubicación | Tipo | Obligatorio | Descripción | Restricciones |
| --- | --- | --- | --- | --- | --- |
| `X-Request-Id` | header | `string` | no | Identificador opcional para rastrear la solicitud; CloudPrint devuelve un valor seguro en la cabecera de respuesta. | maxLength: 128; example: `"order-100045-attempt-1"` |
### Cuerpo de la solicitud
El método no tiene cuerpo de solicitud.
### Ejemplos de solicitud
#### cURL
```bash
curl -sS https://public-api.cloudprint.me/agent-download-api/v1/releases
```
## Respuesta
**Estado HTTP:** `200` — Solicitud completada.
### Campos de respuesta
| Nombre | Tipo | Obligatorio | Descripción | Restricciones |
| --- | --- | --- | --- | --- |
| `available` | `boolean` | sí | Indica si hay un instalador publicado para la plataforma solicitada. | — |
| `channel` | `string \| null` | sí | Canal de publicación al que pertenece esta versión del agente. | — |
| `releases` | `array` | sí | Instaladores del agente publicados, agrupados por plataforma compatible. | — |
| `unavailable_reason` | `string \| null` | no | Motivo por el que no hay un instalador publicado para esta plataforma. | — |
### Ejemplo de respuesta
```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"
}
]
}
]
}
```
## Errores
| Estado HTTP | Descripción |
| --- | --- |
| `429` | Se superó el límite de solicitudes; respeta Retry-After. |
| `500` | Error interno de CloudPrint. |
| `503` | Servicio temporalmente no disponible. |
## Documentación relacionada