API: Creatorinnen, Identität und Persona

Eine creator ist eine Person, die Ihre Agentur auf Telegram betreut. Sie hat eine identity (wer sie ist), eine persona (wie sie spricht, auf acht Seiten) und Verknüpfungen zu ihren Telegram-Konten, ihrem AI Brain, ihrem Vault und ihren Scripts. Diese Endpunkte entsprechen der Creators-Seite in der Console.

Endpunkte #

Das creator-Objekt #

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

Eine pausierte creator behält ihre Konten verbunden, aber die KI antwortet nicht mehr. Bereits laufende Scripts stoppen beim nächsten Schritt.

Creators #

Creatorinnen auflisten #

GET /creators · can_setup oder 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
}

Eine creator anlegen #

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

Die Antwort ist die neue creator (201). Sie startet mit leerer Identität und Persona, ohne Konto und ohne Brain: Der setup-Zähler zeigt, was noch offen ist, wie die Setup-Karte in der Console. Fehlt der name, kommt eine 400-Antwort.

Eine creator abrufen #

GET /creators/{id} · can_setup oder can_fan_read

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

Die Antwort ist das creator-Objekt. Eine unbekannte ID ergibt 404.

Eine creator aktualisieren #

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

Die Antwort ist die aktualisierte creator. Ein brain_id aus einem anderen Workspace ergibt 404.

Pausieren und fortsetzen #

POST /creators/{id}/pause und 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)"

Das Pausieren stoppt die KI auf allen ihren Konten gleichzeitig; resume schaltet sie wieder ein. Beide antworten mit dem creator-Objekt und dem neuen Status.

Eine creator archivieren #

DELETE /creators/{id} · can_setup

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

Die Antwort ist die creator mit status: "archived". Ihre Fans und Verkäufe bleiben erhalten und zählen weiterhin in Ihren Statistiken.

Identität #

Identität abrufen #

GET /creators/{id}/identity · can_setup

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

Die Antwort enthält die gleichen Felder wie unten bei der Identität.

Identität ersetzen #

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 wird aus dem Geburtsdatum berechnet. Eine creator unter 18 wird abgelehnt (400). PUT ersetzt die gesamte Karte: Ein ausgelassenes Feld wird geleert.

Persona #

Die Persona hat die gleichen acht Seiten wie die Console: appearance, life, voice, mimic, personality, memory, boundaries, examples. Jede Seite ist ein Objekt mit Textfeldern; PATCH ändert nur die Seiten, die Sie senden.

Persona abrufen #

GET /creators/{id}/persona · can_engine

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

Die Antwort hat das gleiche Format wie unten, mit allen acht Seiten.

Persona-Seiten ändern #

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-Fortschritt #

Die Setup-Karte abrufen #

GET /creators/{id}/setup · can_setup

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

Die Antwort listet jeden Schritt der Setup-Karte in der Console und ob er erledigt ist. setup im creator-Objekt zeigt denselben Fortschritt als Zähler (done von total).