---
title: "Agent eines verwalteten Kunden widerrufen"
description: "Widerrufen Sie einen verlorenen oder ersetzten Agenten und setzen Sie seine Drucker offline."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/de/docs/">CloudPrint-Dokumentation</a><span aria-hidden="true">/</span><span>API-Referenz</span></nav>

# Agent eines verwalteten Kunden widerrufen

<p class="docs-lead">Widerrufen Sie einen verlorenen oder ersetzten Agenten und setzen Sie seine Drucker offline.</p>

<div class="api-endpoint-summary"><span class="api-method api-method-delete">DELETE</span><code>/partner-api/v1/accounts/{relationshipId}/agents/{agentId}</code><span><strong>API-Version:</strong> v1</span><span><strong>operationId:</strong> <code>revokePartnerManagedAgent</code></span><a href="/de/docs/api/v1/partner/agents/revoke/index.md">Als Markdown anzeigen</a></div>

## Funktion dieser Methode

Widerrufen Sie einen verlorenen oder ersetzten Agenten und setzen Sie seine Drucker offline.

## Authentifizierung

Senden Sie eine einmalige RS256-Assertion der Developer Application in `Authorization: Bearer <application_assertion>`. Sie ist kein Public-API-Zugriffstoken.

## Anfrage

**Produktions-URL:** `https://public-api.cloudprint.me/partner-api/v1/accounts/{relationshipId}/agents/{agentId}`

### Parameter

| Name | Position | Typ | Erforderlich | Beschreibung | Einschränkungen |
| --- | --- | --- | --- | --- | --- |
| `relationshipId` | path | `string (uuid)` | ja | Stabile UUID der Partnerbeziehung zum verwalteten Kunden. | — |
| `agentId` | path | `string (uuid)` | ja | Stabile UUID des Agenten eines verwalteten Kunden im Pfad. | — |
| `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 -X DELETE "https://public-api.cloudprint.me/partner-api/v1/accounts/$RELATIONSHIP_ID/agents/$AGENT_ID" \
  -H "Authorization: Bearer $APPLICATION_ASSERTION"
```

## Antwort

**HTTP-Status:** `204` — Vorgang ohne Antwortinhalt abgeschlossen.

## Fehler

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

## Verwandte Dokumentation

<div class="docs-card-grid"><a class="docs-card" href="/de/docs/api/v1/partner/agents/list/"><strong>Agents eines verwalteten Kunden auflisten</strong><span>Rufen Sie alle mit einem verwalteten Kunden verbundenen Agents einschließlich widerrufener Agents ab.</span></a>
<a class="docs-card" href="/de/docs/api/v1/partner/agent-enrollments/create/"><strong>Verwaltetes Agent Enrollment erstellen</strong><span>Stellen Sie vor oder nach dem Kunden-Onboarding ein idempotentes, einmaliges Enrollment aus.</span></a>
<a class="docs-card" href="/de/docs/partner-platform/agent-enrollment/"><strong>Kunden-Agent verbinden</strong><span>Verbinden Sie CloudPrint Agent ohne Anmeldung im Kundenportal mit dem richtigen verwalteten Konto.</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>