Revocar un Agent Enrollment
Revoca un Enrollment aún no utilizado para que su código secreto ya no pueda conectar un agente.
DELETE
/partner-api/v1/accounts/{relationshipId}/agent-enrollments/{enrollmentId}Versión de la API: v1operationId: revokePartnerAgentEnrollmentVer como MarkdownQué 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
Listar Agent Enrollments gestionadosConsulta Agent Enrollments pendientes, utilizados, caducados y revocados sin exponer sus códigos secretos.Crear un Agent Enrollment gestionadoGenera un Enrollment idempotente de un solo uso antes o después de incorporar al cliente.Conectar un agente de clienteVincula CloudPrint Agent con la cuenta administrada correcta sin iniciar sesión en el panel del cliente.