---
title: "Отозвать Agent Enrollment"
description: "Отзовите неиспользованный Enrollment, чтобы его секретный код больше нельзя было применить для подключения агента."
---
<nav class="docs-breadcrumb" aria-label="Breadcrumb"><a href="/docs/">Документация CloudPrint</a><span aria-hidden="true">/</span><span>Справочник API</span></nav>

# Отозвать Agent Enrollment

<p class="docs-lead">Отзовите неиспользованный Enrollment, чтобы его секретный код больше нельзя было применить для подключения агента.</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>Версия API:</strong> v1</span><span><strong>operationId:</strong> <code>revokePartnerAgentEnrollment</code></span><a href="/docs/api/v1/partner/agent-enrollments/revoke/index.md">Открыть в Markdown</a></div>

## Назначение метода

Отзовите неиспользованный Enrollment, чтобы его секретный код больше нельзя было применить для подключения агента.

## Авторизация

Передавайте одноразовое JWT-подтверждение Developer Application, подписанное RS256, в `Authorization: Bearer <application_assertion>`. Это не токен доступа к Public API.

## Запрос

**Основной адрес API:** `https://public-api.cloudprint.me/partner-api/v1/accounts/{relationshipId}/agent-enrollments/{enrollmentId}`

### Параметры

| Имя | Расположение | Тип | Обязательно | Описание | Ограничения |
| --- | --- | --- | --- | --- | --- |
| `relationshipId` | path | `string (uuid)` | да | Поле контракта API; учитывайте указанные тип и ограничения. | — |
| `enrollmentId` | path | `string (uuid)` | да | Поле контракта API; учитывайте указанные тип и ограничения. | — |

### Тело запроса

У метода нет тела запроса.

### Примеры запросов

#### 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"
```

## Ответ

**HTTP-статус:** `204` — Операция выполнена без тела ответа.

## Ошибки

| HTTP-статус | Описание |
| --- | --- |
| `401` | Авторизация отсутствует или недействительна. |
| `403` | Для операции недостаточно разрешений. |
| `404` | Запрошенный ресурс не найден. |
| `422` | Поля запроса не прошли проверку. |
| `429` | Превышен лимит запросов; учитывайте Retry-After. |
| `500` | Внутренняя ошибка CloudPrint. |

## Рекомендации по интеграции

## Связанная документация

<div class="docs-card-grid"><a class="docs-card" href="/docs/api/v1/partner/agent-enrollments/list/"><strong>Получить список Agent Enrollment</strong><span>Получите Agent Enrollment со статусами `pending`, `claimed`, `expired` и `revoked` без секретных кодов.</span></a>
<a class="docs-card" href="/docs/api/v1/partner/agent-enrollments/create/"><strong>Создать Agent Enrollment</strong><span>Создайте одноразовое подключение агента, которое можно безопасно повторить до или после первоначального подключения клиента.</span></a>
<a class="docs-card" href="/docs/partner-platform/agent-enrollment/"><strong>Подключение агента клиента</strong><span>Подключите локальный CloudPrint Agent к правильному управляемому аккаунту без входа клиента в кабинет CloudPrint.</span></a></div>

<nav class="docs-resource-links" aria-label="Следующие шаги"><a href="/docs/api/v1/explorer/">OpenAPI</a><a href="https://my.cloudprint.by">Открыть кабинет</a><a href="/docs/legal/privacy/">Политика конфиденциальности</a><a href="/docs/legal/terms/">Условия использования</a><a href="/docs/legal/payments-and-refunds/">Оплата и возврат</a><a href="/docs/legal/data-processing/">DPA</a></nav>