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

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

Endpoints #

The creator object #

{
  "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"
}

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

Creators #

List creators #

GET /creators · can_setup або can_fan_read

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

{
  "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

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"}'

{
  "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

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

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

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

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

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

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"]}'

{
  "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

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

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

Change persona pages #

PATCH /creators/{id}/persona · can_engine

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"}]}}'

{
  "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"
}

Setup progress #

Get the Setup card #

GET /creators/{id}/setup · can_setup

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

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