---
title: "Revocar un Agent Enrollment"
description: "Revoca un Enrollment aún no utilizado para que su código secreto ya no pueda conectar un agente."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/es/docs/">Documentación de CloudPrint</a><span aria-hidden="true">/</span><span>Referencia de la API</span></nav>

# Revocar un Agent Enrollment

<p class="docs-lead">Revoca un Enrollment aún no utilizado para que su código secreto ya no pueda conectar un agente.</p>

<div class="api-endpoint-summary"><span class="api-method api-method-delete">DELETE</span><code>/partner-api/v1/accounts/{relationshipId}/agent-enrollments/{enrollmentId}</code><span><strong>Versión de la API:</strong> v1</span><span><strong>operationId:</strong> <code>revokePartnerAgentEnrollment</code></span><a href="/es/docs/api/v1/partner/agent-enrollments/revoke/index.md">Ver como Markdown</a></div>

## Qué hace este método

Revoca un Enrollment aún no utilizado para que su código secreto ya no pueda conectar un agente.

## Autenticación

Envía una aserción RS256 de un solo uso de la Developer Application en `Authorization: Bearer <application_assertion>`. No es un token de acceso de Public API.

## Solicitud

**URL de producción:** `https://public-api.cloudprint.me/partner-api/v1/accounts/{relationshipId}/agent-enrollments/{enrollmentId}`

### Parámetros

| Nombre | Ubicación | Tipo | Obligatorio | Descripción | Restricciones |
| --- | --- | --- | --- | --- | --- |
| `relationshipId` | path | `string (uuid)` | sí | UUID estable de la relación del partner con el cliente gestionado. | — |
| `enrollmentId` | path | `string (uuid)` | sí | UUID estable del Agent Enrollment indicado en la ruta. | — |
| `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 -X DELETE \
  "https://public-api.cloudprint.me/partner-api/v1/accounts/$RELATIONSHIP_ID/agent-enrollments/$ENROLLMENT_ID" \
  -H "Authorization: Bearer $APPLICATION_ASSERTION"
```

## Respuesta

**Estado HTTP:** `204` — Operación completada sin cuerpo de respuesta.

## Errores

| Estado HTTP | Descripción |
| --- | --- |
| `401` | Falta la autenticación o no es válida. |
| `403` | El token no tiene permisos suficientes. |
| `404` | No se encontró el recurso. |
| `422` | Uno o varios campos no son válidos. |
| `429` | Se superó el límite de solicitudes; respeta Retry-After. |
| `500` | Error interno de CloudPrint. |

## Documentación relacionada

<div class="docs-card-grid"><a class="docs-card" href="/es/docs/api/v1/partner/agent-enrollments/list/"><strong>Listar Agent Enrollments gestionados</strong><span>Consulta Agent Enrollments pendientes, utilizados, caducados y revocados sin exponer sus códigos secretos.</span></a>
<a class="docs-card" href="/es/docs/api/v1/partner/agent-enrollments/create/"><strong>Crear un Agent Enrollment gestionado</strong><span>Genera un Enrollment idempotente de un solo uso antes o después de incorporar al cliente.</span></a>
<a class="docs-card" href="/es/docs/partner-platform/agent-enrollment/"><strong>Conectar un agente de cliente</strong><span>Vincula CloudPrint Agent con la cuenta administrada correcta sin iniciar sesión en el panel del cliente.</span></a></div>

<nav class="docs-resource-links" aria-label="Siguientes pasos"><a href="https://cloudprint.me/status/">Estado del servicio</a><a href="/es/docs/api/v1/explorer/">OpenAPI</a><a href="https://developer.cloudprint.me">Developer Portal</a><a href="https://my.cloudprint.me">Abrir cuenta</a><a href="/docs/legal/privacy/">Política de privacidad</a><a href="/docs/legal/terms/">Términos de uso</a><a href="/docs/legal/payments-and-refunds/">Pagos y reembolsos</a><a href="/docs/legal/data-processing/">Tratamiento de datos</a><a href="/docs/legal/service-level-agreement/">Service Level Agreement</a></nav>