> ## Documentation Index
> Fetch the complete documentation index at: https://docs.conare.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Життєвий цикл кінцевого користувача

> Привʼязка відображуваної ідентичності до непрозорих тенантів кінцевих користувачів, GDPR-видалення користувачів і як утримання враховує активність конекторів.

Кожен виклик до памʼяті містить `endUserId` — ваш стабільний ідентифікатор вашого користувача (1–128 символів, `A-Za-z0-9@._-`). Conare ніколи не зберігає його у відкритому вигляді: фізичний тенант — це непрозорий HMAC, похідний від вашої інтеграції та цього ID, а ізоляція завжди виконується за хешем. Ця сторінка охоплює дві операції життєвого циклу, які належать вам — маркування та видалення, — а також як автоматичне утримання взаємодіє з конекторами.

## Привʼязка відображуваної ідентичності

За замовчуванням реєстр End Users у вашій панелі показує непрозорі хеші. Надішліть відображуване імʼя та/або email, щоб реєстр показував людей замість хешів:

```bash theme={null}
curl -X PUT https://api.conare.ai/api/v1/users/u_123 \
  -H "Authorization: Bearer $CONARE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Ada Lovelace", "email": "ada@example.com" }'
```

Або через SDK:

```ts theme={null}
await conare.setUserIdentity({
  endUserId: "u_123",
  name: "Ada Lovelace",
  email: "ada@example.com",
});
```

Семантика:

* **Лише косметика.** `endUserId` залишається HMAC-хешованим на боці Conare; отримання, ізоляція та білінг досі виконуються за хешем. Ця мітка змінює лише те, що *ви* бачите в реєстрі.
* **Часткові оновлення.** Надішліть рядок, щоб задати поле, `null` — щоб очистити його, пропустіть ключ — щоб залишити без змін. Вкажіть принаймні одне з `name` або `email`.
* **Обмеження.** `name` — до 120 символів, `email` — до 254 символів (перевіряється формат на наявність `@`; без перевірки доставленості — гігієна адрес ваших користувачів на вас).
* **Не тарифікується.** Виклик безкоштовний і не рахується як активність кінцевого користувача, тому маркування неактивного користувача не подовжить його вікно утримання.

Коли використовувати: викликайте це щоразу, коли ви вже знаєте відображувану ідентичність користувача — наприклад, одразу після його реєстрації або коли ви вперше запускаєте інтеграцію і хочете заповнити мітки для наявних користувачів. Це необовʼязково; якщо пропустити, реєстр просто продовжить показувати хеші.

## Видалення кінцевого користувача (GDPR-стирання)

`DELETE /api/v1/users/{endUserId}` — це повне, незворотне знищення. Впроваджуйте його у ваш потік видалення облікового запису.

```bash theme={null}
curl -X DELETE https://api.conare.ai/api/v1/users/u_123 \
  -H "Authorization: Bearer $CONARE_KEY"
```

```ts theme={null}
await conare.deleteUser("u_123");
```

Одним викликом Conare:

1. **Спочатку відкликає ресурси конекторного плейну** — усі утримання OAuth та ресурси конекторів на користувача знищуються до стирання памʼяті. Якщо конекторний плейн недоступний, виклик повертає `503`, щоб ви могли повторити спробу; стирання, яке залишило б живий OAuth-токен, було б хибним успіхом.
2. **Стирає плейн памʼяті** — кожну памʼять, кожен вектор, кожен контейнер цього користувача.
3. **Скидає стан конекторів** — стан конекторів на користувача, який використовується для відновлення інкрементальних синхронізацій.
4. **Видаляє рядок з реєстру** — користувач зникає з вашої панелі End Users.

Фонові синхронізації, що виконуються, не можуть воскресити видаленого користувача. Якщо під час видалення виконується синхронізація конектора, вона перериває свій запуск, а не записує у стертий тенант.

<Note>
  `DELETE` завжди виконується миттєво і завжди на всього користувача, незалежно від вашої політики утримання. Мʼякого видалення чи пільгового періоду немає.
</Note>

## Автоматичне утримання

У розділі **Platform → Retention** можна задати максимальне вікно неактивності. Щойно вікно налаштовано, Conare автоматично видаляє будь-якого кінцевого користувача, що простоював довше — таке видалення виконує те саме повне знищення, що й явний `DELETE /api/v1/users/{endUserId}` (плейн памʼяті, стан конекторів, рядок реєстру, відкликання OAuth).

Що вважається активністю:

* Будь-який виклик партнерського API, що містить користувача — включно з читанням (`search`, `recall`, `suggestions`) і записом (`memories`, `containers`).
* **Синхронізації конекторів вважаються активністю.** Користувач з активним конектором утримується, доки ви його не відʼєднаєте. Якщо ви хочете, щоб автоматичне утримання застосовувалося до підʼєднаних користувачів, спершу відʼєднайте конектор (або видаліть користувача явно).

Що не вважається активністю:

* `PUT /api/v1/users/{endUserId}` (задання відображуваної ідентичності) — маркування неактивного користувача не подовжує утримання.
* Перегляди реєстру в панелі.

Залиште поле порожнім, щоб зберігати користувачів назавжди. Явні запити `DELETE` завжди виконуються негайно, незалежно від налаштувань утримання.