# API: авторки, identity та persona

_API · Читання 6 хв · Оновлено 2026-10-22 · https://lanachat.ai/guides/uk/api-creators/_

**Авторка**, це людина, яку ваша агенція веде у Telegram. Вона має **identity** (хто вона), **persona** (як вона спілкується, опис на восьми сторінках), а також пов’язані Telegram-акаунти, AI Brain, Vault і скрипти. Ці endpoints відповідають сторінці **Creators** у Console.

## Endpoints

| Method | Path | Description | Permission | Status |
|---|---|---|---|---|
| GET | `/creators` | Список авторок (`status=active,paused,archived`, `q=` пошук за іменем) | `can_setup` або `can_fan_read` | Planned |
| POST | `/creators` | Створити авторку (ім’я обов’язкове) | `can_setup` | Planned |
| GET | `/creators/{id}` | Одна авторка з прогресом налаштування | `can_setup` або `can_fan_read` | Planned |
| PATCH | `/creators/{id}` | Змінити ім’я, фото, часовий пояс або brain | `can_setup` | Planned |
| POST | `/creators/{id}/pause` | Призупинити: AI перестає відповідати на всіх акаунтах | `can_setup` | Planned |
| POST | `/creators/{id}/resume` | Відновити призупинену авторку | `can_setup` | Planned |
| DELETE | `/creators/{id}` | Архівувати (фани та продажі зберігаються) | `can_setup` | Planned |
| GET | `/creators/{id}/identity` | Картка identity | `can_setup` | Planned |
| PUT | `/creators/{id}/identity` | Замінити картку identity | `can_setup` | Planned |
| GET | `/creators/{id}/persona` | Вісім сторінок persona та їхня заповненість | `can_engine` | Planned |
| PATCH | `/creators/{id}/persona` | Змінити одну чи кілька сторінок persona | `can_engine` | Planned |
| GET | `/creators/{id}/setup` | Картка Setup: кожен крок і його виконання | `can_setup` | Planned |

## The creator object

```json
{
  "id": "cr_lea",
  "name": "Lea",
  "status": "active",
  "photo_url": "https://cdn.lanachat.ai/w/7Hq2/cr_lea/photo.jpg",
  "timezone": "Europe/Paris",
  "brain_id": "br_lea_main",
  "accounts": { "total": 3, "connected": 2 },
  "setup": { "done": 5, "total": 7 },
  "created_at": "2026-08-14T09:12:00Z",
  "updated_at": "2026-10-05T18:40:11Z"
}
```

| Field | Type | Description |
|---|---|---|
| `id` | string | Починається з `cr_` |
| `name` | string | Її ім’я у Console |
| `status` | string | `active`, `paused` або `archived` |
| `photo_url` | string або null | Її фото |
| `timezone` | string | IANA-часовий пояс, наприклад `Europe/Paris` |
| `brain_id` | string або null | AI Brain, прив’язаний до неї |
| `accounts` | object | Кількість Telegram-акаунтів: `total`, `connected` |
| `setup` | object | Кроки картки Setup: `done` з `total` |
| `created_at`, `updated_at` | string | ISO 8601, UTC |

Призупинена авторка зберігає підключення акаунтів, але AI не відповідає; скрипти, що вже працюють, зупиняються на наступному кроці.

## Creators

### List creators

`GET /creators` · `can_setup` або `can_fan_read`

| Parameter | Type | Required | Description |
|---|---|---|---|
| `status` | string | No | `active`, `paused` або `archived`; кілька через кому |
| `q` | string | No | Частина імені |
| `limit`, `cursor` | number, string | No | [Pagination](https://lanachat.ai/guides/uk/api-overview/) |

```bash
curl "https://api.lanachat.ai/v1/creators?status=active,paused" \
  -H "Authorization: Bearer $LANACHAT_TOKEN"
```

```json
{
  "data": [
    { "id": "cr_lea", "name": "Lea", "status": "active", "photo_url": "https://cdn.lanachat.ai/w/7Hq2/cr_lea/photo.jpg", "timezone": "Europe/Paris", "brain_id": "br_lea_main", "accounts": { "total": 3, "connected": 2 }, "setup": { "done": 5, "total": 7 }, "created_at": "2026-08-14T09:12:00Z", "updated_at": "2026-10-05T18:40:11Z" },
    { "id": "cr_mia", "name": "Mia", "status": "paused", "photo_url": null, "timezone": "Europe/Rome", "brain_id": "br_mia_main", "accounts": { "total": 2, "connected": 2 }, "setup": { "done": 7, "total": 7 }, "created_at": "2026-07-02T11:00:00Z", "updated_at": "2026-10-01T08:15:00Z" }
  ],
  "next_cursor": null
}
```

### Create a creator

`POST /creators` · `can_setup`

| Parameter | Type | Required | Description |
|---|---|---|---|
| `name` | string | Yes | Її ім’я у Console |
| `timezone` | string | No | IANA-часовий пояс |

```bash
curl -X POST https://api.lanachat.ai/v1/creators \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"name": "Lea", "timezone": "Europe/Paris"}'
```

```json
{
  "id": "cr_lea",
  "name": "Lea",
  "status": "active",
  "photo_url": null,
  "timezone": "Europe/Paris",
  "brain_id": null,
  "accounts": { "total": 0, "connected": 0 },
  "setup": { "done": 0, "total": 7 },
  "created_at": "2026-10-06T14:00:00Z",
  "updated_at": "2026-10-06T14:00:00Z"
}
```

Відповідь, нова авторка (`201`). Вона починає з порожньою identity та persona, без акаунтів і brain: лічильник `setup` показує, що ще залишилось, як у картці Setup у Console. Якщо немає `name`, повертається `400`.

### Get a creator

`GET /creators/{id}` · `can_setup` або `can_fan_read`

```bash
curl https://api.lanachat.ai/v1/creators/cr_lea \
  -H "Authorization: Bearer $LANACHAT_TOKEN"
```

Відповідь, creator object. Якщо id невідомий, повертається `404`.

### Update a creator

`PATCH /creators/{id}` · `can_setup`

| Parameter | Type | Required | Description |
|---|---|---|---|
| `name` | string | No | Нове ім’я |
| `timezone` | string | No | IANA-часовий пояс |
| `brain_id` | string або null | No | Brain для прив’язки; `null`, відв’язати |

```bash
curl -X PATCH https://api.lanachat.ai/v1/creators/cr_lea \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"timezone": "Europe/Madrid", "brain_id": "br_lea_main"}'
```

Відповідь, оновлена авторка. Якщо `brain_id` з іншого workspace, повертається `404`.

### Pause and resume

`POST /creators/{id}/pause` та `POST /creators/{id}/resume` · `can_setup`

```bash
curl -X POST https://api.lanachat.ai/v1/creators/cr_lea/pause \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)"
```

Призупинення зупиняє AI на всіх її акаунтах одразу; `resume` вмикає його знову. Обидві відповіді, creator object з новим статусом.

### Archive a creator

`DELETE /creators/{id}` · `can_setup`

```bash
curl -X DELETE https://api.lanachat.ai/v1/creators/cr_lea \
  -H "Authorization: Bearer $LANACHAT_TOKEN"
```

Відповідь, авторка зі `status: "archived"`. Її фани та продажі зберігаються і враховуються у вашій статистиці.

## Identity

### Get the identity

`GET /creators/{id}/identity` · `can_setup`

```bash
curl https://api.lanachat.ai/v1/creators/cr_lea/identity \
  -H "Authorization: Bearer $LANACHAT_TOKEN"
```

Відповідь має ті ж поля, що й identity нижче.

### Replace the identity

`PUT /creators/{id}/identity` · `can_setup`

| Parameter | Type | Required | Description |
|---|---|---|---|
| `first_name` | string | No | Її ім’я, як його знають фани |
| `nicknames` | array of strings | No | Короткі імена, на які вона відгукується |
| `date_of_birth` | string | No | `YYYY-MM-DD`; їй має бути 18+ |
| `nationality` | string | No | Дволітерний код країни, наприклад `FR` |
| `languages` | array of strings | No | Мови, якими вона володіє, наприклад `["fr", "en"]` |

```bash
curl -X PUT https://api.lanachat.ai/v1/creators/cr_lea/identity \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Lea", "nicknames": ["Lele"], "date_of_birth": "2001-04-12", "nationality": "FR", "languages": ["fr", "en"]}'
```

```json
{
  "first_name": "Lea",
  "nicknames": ["Lele"],
  "date_of_birth": "2001-04-12",
  "zodiac_sign": "aries",
  "nationality": "FR",
  "languages": ["fr", "en"]
}
```

`zodiac_sign` визначається за датою народження. Якщо авторці менше 18, повертається помилка (`400`). `PUT` замінює всю картку: поле, яке ви не передаєте, буде очищено.

## Persona

Persona має ті ж вісім сторінок, що й у Console: `appearance`, `life`, `voice`, `mimic`, `personality`, `memory`, `boundaries`, `examples`. Кожна сторінка, це об’єкт із текстовими полями; `PATCH` змінює лише надіслані сторінки.

### Get the persona

`GET /creators/{id}/persona` · `can_engine`

```bash
curl https://api.lanachat.ai/v1/creators/cr_lea/persona \
  -H "Authorization: Bearer $LANACHAT_TOKEN"
```

Відповідь має таку ж структуру, як нижче, з усіма вісьмома сторінками.

### Change persona pages

`PATCH /creators/{id}/persona` · `can_engine`

| Parameter | Type | Required | Description |
|---|---|---|---|
| `appearance`, `life`, `voice`, `mimic`, `personality`, `memory`, `boundaries`, `examples` | object | At least one | Сторінки для зміни; інші залишаються |

```bash
curl -X PATCH https://api.lanachat.ai/v1/creators/cr_lea/persona \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"voice": {"style": "Short, warm, a few emojis, never formal.", "phrase_bank": [{"trigger": "Are you a bot?", "reply": "Haha no, just slow at typing"}]}}'
```

```json
{
  "complete_percent": 64,
  "pages": {
    "voice": { "style": "Short, warm, a few emojis, never formal.", "phrase_bank": [ { "trigger": "Are you a bot?", "reply": "Haha no, just slow at typing" } ], "complete": true },
    "mimic": { "enabled": false, "lines": [], "complete": false }
  },
  "reply_language": "fr"
}
```

> Tip: Persona використовується у всіх brain, прив’язаних до авторки. Змінюйте її у спокійний час, а потім протестуйте brain у [Playground](https://lanachat.ai/guides/uk/api-ai-brains/) до пікового навантаження.

## Setup progress

### Get the Setup card

`GET /creators/{id}/setup` · `can_setup`

```bash
curl https://api.lanachat.ai/v1/creators/cr_lea/setup \
  -H "Authorization: Bearer $LANACHAT_TOKEN"
```

Відповідь містить кожен крок картки Setup у Console та інформацію, чи виконано його. `setup` у creator object, це той самий прогрес у вигляді лічильника (`done` з `total`).

## Пов’язані статті

- [LanaChat API: швидкий старт, автентифікація та помилки](https://lanachat.ai/guides/uk/api-overview/)
- [Додати авторку](https://lanachat.ai/guides/uk/add-a-creator/)
- [Налаштування авторки (персона, ціни, мова)](https://lanachat.ai/guides/uk/creator-settings/)