---
title: "Verbundene Agents auflisten"
description: "Rufen Sie die CloudPrint Agents des Kontos ab und prüfen Sie Verbindung, Version und verfügbares Update."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/de/docs/">CloudPrint-Dokumentation</a><span aria-hidden="true">/</span><span>API-Referenz</span></nav>

# Verbundene Agents auflisten

<p class="docs-lead">Rufen Sie die CloudPrint Agents des Kontos ab und prüfen Sie Verbindung, Version und verfügbares Update.</p>

<div class="api-endpoint-summary"><span class="api-method api-method-get">GET</span><code>/api/v1/agents</code><span><strong>API-Version:</strong> v1</span><span><strong>operationId:</strong> <code>listAgents</code></span><a href="/de/docs/api/v1/agents/list/index.md">Als Markdown anzeigen</a></div>

## Funktion dieser Methode

Rufen Sie die CloudPrint Agents des Kontos ab und prüfen Sie Verbindung, Version und verfügbares Update.

## Authentifizierung

Senden Sie ein kurzlebiges Token in `Authorization: Bearer <access_token>`.

**Erforderliche Scopes:** `agents:read`

## Anfrage

**Produktions-URL:** `https://public-api.cloudprint.me/api/v1/agents`

### Parameter

| Name | Position | Typ | Erforderlich | Beschreibung | Einschränkungen |
| --- | --- | --- | --- | --- | --- |
| `limit` | query | `integer` | nein | Höchstzahl der Ressourcen auf einer Ergebnisseite. | min: 1; max: 100; default: `50` |
| `cursor` | query | `string \| null` | nein | Opaker Cursor der angefragten Ergebnisseite; senden Sie ihn unverändert zurück. | — |
| `X-Request-Id` | header | `string` | nein | Optionale Kennung zur Anfrageverfolgung; CloudPrint gibt einen sicheren Wert im Antwort-Header zurück. | maxLength: 128; example: `"order-100045-attempt-1"` |

### Anfrageinhalt

Die Methode hat keinen Anfrageinhalt.

### Anfragebeispiele

#### cURL

```bash
curl -sS 'https://public-api.cloudprint.me/api/v1/agents?limit=50' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

## Antwort

**HTTP-Status:** `200` — Anfrage erfolgreich.

### Antwortfelder

| Name | Typ | Erforderlich | Beschreibung | Einschränkungen |
| --- | --- | --- | --- | --- |
| `agents` | `array` | ja | Im aktuellen CloudPrint-Konto registrierte Agents. | — |
| `next_cursor` | `string \| null` | ja | Opaker Cursor für die nächste Ergebnisseite; senden Sie ihn unverändert zurück. | — |

### Beispielantwort

```json
{
  "agents": [
    {
      "agent_id": "11111111-1111-4111-8111-111111111111",
      "name": "Warehouse PC agent",
      "status": "online",
      "agent_instance_id": "string",
      "hostname": "string",
      "version": "string",
      "update": {
        "status": "available",
        "current_version": "0.1.0",
        "latest_version": "0.1.1",
        "minimum_supported_version": "0.1.0",
        "channel": "stable",
        "required": false
      },
      "last_seen_at": "2026-08-06T12:00:00Z"
    }
  ],
  "next_cursor": "string"
}
```

## Fehler

| HTTP-Status | Beschreibung |
| --- | --- |
| `401` | Authentifizierung fehlt oder ist ungültig. |
| `403` | Das Token hat nicht die erforderlichen Berechtigungen. |
| `422` | Mindestens ein Feld ist ungültig. |
| `429` | Anfragelimit überschritten; beachten Sie Retry-After. |
| `500` | Interner CloudPrint-Fehler. |

## Hinweise zur Integration

- Behandeln Sie den Agent-Status als Betriebsinformation, nicht als Routing-Schlüssel.
- Prüfen Sie den Aktualisierungsstatus vor der Diagnose von Drucker- oder Dokumentfehlern.

## Verwandte Dokumentation

<div class="docs-card-grid"><a class="docs-card" href="/de/docs/api/agents-and-printers/"><strong>Agenten und Drucker</strong><span>Verbinden Sie Computer, erkennen Sie Druckerwarteschlangen und wählen Sie stabile Drucker-IDs.</span></a>
<a class="docs-card" href="/de/docs/api/v1/printers/list/"><strong>Verfügbare Drucker auflisten</strong><span>Rufen Sie die über verbundene Agents sichtbaren Drucker ab und wählen Sie eine stabile Drucker-ID für Ihre Integration.</span></a>
<a class="docs-card" href="/de/docs/troubleshooting/"><strong>Fehlerbehebung</strong><span>Untersuchen Sie fehlgeschlagene Druckaufträge, ohne versehentlich eine zweite Kopie zu erzeugen.</span></a></div>

<nav class="docs-resource-links" aria-label="Nächste Schritte"><a href="https://cloudprint.me/status/">Dienststatus</a><a href="/de/docs/api/v1/explorer/">OpenAPI</a><a href="https://developer.cloudprint.me">Developer Portal</a><a href="https://my.cloudprint.me">Konto öffnen</a><a href="/docs/legal/privacy/">Datenschutzerklärung</a><a href="/docs/legal/terms/">Nutzungsbedingungen</a><a href="/docs/legal/payments-and-refunds/">Zahlungen und Erstattungen</a><a href="/docs/legal/data-processing/">DPA</a><a href="/docs/legal/service-level-agreement/">Service Level Agreement</a></nav>