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

# Изменить состояние управляемого клиента

<p class="docs-lead">Приостановите, возобновите или навсегда закройте отношения с клиентом партнёрского приложения.</p>

<div class="api-endpoint-summary"><span class="api-method api-method-post">POST</span><code>/partner-api/v1/accounts/{relationshipId}/{action}</code><span><strong>Версия API:</strong> v1</span><span><strong>operationId:</strong> <code>changePartnerManagedAccountState</code></span><a href="/docs/api/v1/partner/accounts/change-state/index.md">Открыть в Markdown</a></div>

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

Приостановите, возобновите или навсегда закройте отношения с клиентом партнёрского приложения.

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

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

## Запрос

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

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

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

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

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

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

#### cURL

```bash
curl -sS -X POST "https://public-api.cloudprint.me/partner-api/v1/accounts/$RELATIONSHIP_ID/suspend" \
  -H "Authorization: Bearer $APPLICATION_ASSERTION"
```

## Ответ

**HTTP-статус:** `200` — Запрос выполнен.

### Поля ответа

| Имя | Тип | Обязательно | Описание | Ограничения |
| --- | --- | --- | --- | --- |
| `relationship_id` | `string (uuid)` | да | Стабильный идентификатор этого ресурса. | — |
| `developer_account_id` | `string (uuid)` | да | Стабильный идентификатор этого ресурса. | — |
| `cloudprint_account_id` | `string (uuid)` | да | Стабильный идентификатор этого ресурса. | — |
| `external_customer_id` | `string` | да | Стабильный идентификатор этого ресурса. | maxLength: 160 |
| `name` | `string` | да | Поле контракта API; учитывайте указанные тип и ограничения. | maxLength: 120 |
| `application_id` | `string (uuid)` | да | Стабильный идентификатор Developer Application, представленного токеном установки. | — |
| `installation_id` | `string \| null (uuid)` | да | Стабильный UUID App Installation, выдавшей разрешение токену. | — |
| `agent_enrollment_id` | `string \| null (uuid)` | да | Стабильный идентификатор этого ресурса. | — |
| `agent_onboarding_expires_at` | `string \| null (date-time)` | да | Временная метка CloudPrint в формате ISO 8601. | — |
| `agent_onboarding_url` | `string \| null (uri)` | да | Поле контракта API; учитывайте указанные тип и ограничения. | example: `"https://connect.cloudprint.me/setup#token=cpat_example"` |
| `onboarding_status` | `string` | да | Поле контракта API; учитывайте указанные тип и ограничения. | enum: `provisioning`, `waiting_for_agent`, `ready`, `failed` |
| `status` | `string` | да | Текущее состояние ресурса или процесса; учитывайте допустимые значения конкретного метода. | enum: `provisioning`, `active`, `suspended`, `closed` |
| `created_at` | `string (date-time)` | да | Временная метка CloudPrint в формате ISO 8601. | — |
| `updated_at` | `string (date-time)` | да | Временная метка CloudPrint в формате ISO 8601. | — |

### Пример ответа

```json
{
  "relationship_id": "11111111-1111-4111-8111-111111111111",
  "developer_account_id": "11111111-1111-4111-8111-111111111111",
  "cloudprint_account_id": "11111111-1111-4111-8111-111111111111",
  "external_customer_id": "string",
  "name": "string",
  "application_id": "11111111-1111-4111-8111-111111111111",
  "installation_id": null,
  "agent_enrollment_id": null,
  "agent_onboarding_expires_at": null,
  "agent_onboarding_url": "https://connect.cloudprint.me/setup#token=cpat_example",
  "onboarding_status": "provisioning",
  "status": "provisioning",
  "created_at": "2026-08-06T12:00:00Z",
  "updated_at": "2026-08-06T12:00:00Z"
}
```

## Ошибки

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

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

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

<div class="docs-card-grid"><a class="docs-card" href="/docs/api/v1/partner/accounts/list/"><strong>Получить управляемые аккаунты клиентов</strong><span>Получите аккаунты клиентов, созданные партнёрским приложением, включая состояние агентов и принтеров.</span></a>
<a class="docs-card" href="/docs/api/v1/partner/accounts/create/"><strong>Создать управляемый аккаунт клиента</strong><span>Создайте изолированный аккаунт CloudPrint, App Installation и одноразовое подключение агента без регистрации клиента.</span></a>
<a class="docs-card" href="/docs/api/v1/errors/"><strong>Ошибки и повторы CloudPrint API</strong><span>Обрабатывайте HTTP-статусы, машиночитаемые ошибки, ограничения частоты запросов, трассировку и безопасные повторы.</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>