# API: Creatorinnen, Identität und Persona

_API · 6 Min. Lesezeit · Aktualisiert 2026-10-22 · https://lanachat.ai/guides/de/api-creators/_

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

| Method | Path | Description | Permission | Status |
|---|---|---|---|---|
| GET | `/creators` | Creatorinnen auflisten (`status=active,paused,archived`, `q=` Namenssuche) | `can_setup` oder `can_fan_read` | Planned |
| POST | `/creators` | Eine creator anlegen (Name erforderlich) | `can_setup` | Planned |
| GET | `/creators/{id}` | Eine creator mit ihrem Setup-Fortschritt | `can_setup` oder `can_fan_read` | Planned |
| PATCH | `/creators/{id}` | Umbenennen, Foto, Zeitzone oder verknüpftes Brain ändern | `can_setup` | Planned |
| POST | `/creators/{id}/pause` | Creator pausieren: Die KI antwortet nicht mehr auf ihren Konten | `can_setup` | Planned |
| POST | `/creators/{id}/resume` | Eine pausierte creator wieder aktivieren | `can_setup` | Planned |
| DELETE | `/creators/{id}` | Creator archivieren (Fans und Verkäufe bleiben erhalten) | `can_setup` | Planned |
| GET | `/creators/{id}/identity` | Ihre Identitätskarte | `can_setup` | Planned |
| PUT | `/creators/{id}/identity` | Identitätskarte ersetzen | `can_setup` | Planned |
| GET | `/creators/{id}/persona` | Die acht Persona-Seiten und deren Vollständigkeit | `can_engine` | Planned |
| PATCH | `/creators/{id}/persona` | Eine oder mehrere Persona-Seiten ändern | `can_engine` | Planned |
| GET | `/creators/{id}/setup` | Die Setup-Karte: Jeder Schritt und ob er erledigt ist | `can_setup` | Planned |

## Das creator-Objekt

```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 | Beginnt mit `cr_` |
| `name` | string | Ihr Name in der Console |
| `status` | string | `active`, `paused` oder `archived` |
| `photo_url` | string oder null | Ihr Foto |
| `timezone` | string | IANA-Zeitzone, z.B. `Europe/Paris` |
| `brain_id` | string oder null | Das verknüpfte AI Brain |
| `accounts` | object | Anzahl ihrer Telegram-Konten: `total`, `connected` |
| `setup` | object | Schritte der Setup-Karte `done` von `total` |
| `created_at`, `updated_at` | string | ISO 8601, UTC |

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`

| Parameter | Type | Required | Description |
|---|---|---|---|
| `status` | string | No | `active`, `paused` oder `archived`; mehrere durch Kommas getrennt |
| `q` | string | No | Teil ihres Namens |
| `limit`, `cursor` | number, string | No | [Paginierung](https://lanachat.ai/guides/de/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
}
```

### Eine creator anlegen

`POST /creators` · `can_setup`

| Parameter | Type | Required | Description |
|---|---|---|---|
| `name` | string | Yes | Ihr Name in der Console |
| `timezone` | string | No | IANA-Zeitzone |

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

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`

```bash
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`

| Parameter | Type | Required | Description |
|---|---|---|---|
| `name` | string | No | Neuer Name |
| `timezone` | string | No | IANA-Zeitzone |
| `brain_id` | string oder null | No | Das zu verknüpfende Brain; `null` entfernt die Verknüpfung |

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

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`

```bash
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`

```bash
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`

```bash
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`

| Parameter | Type | Required | Description |
|---|---|---|---|
| `first_name` | string | No | Ihr Vorname, wie Fans ihn kennen |
| `nicknames` | array of strings | No | Kurznamen, auf die sie reagiert |
| `date_of_birth` | string | No | `YYYY-MM-DD`; Sie muss mindestens 18 Jahre alt sein |
| `nationality` | string | No | Zweistelliger Ländercode, z.B. `FR` |
| `languages` | array of strings | No | Sprachen, die sie spricht, z.B. `["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` 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`

```bash
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`

| Parameter | Type | Required | Description |
|---|---|---|---|
| `appearance`, `life`, `voice`, `mimic`, `personality`, `memory`, `boundaries`, `examples` | object | Mindestens eine | Die zu ändernden Seiten; die anderen bleiben erhalten |

```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: Die Persona beeinflusst jedes Brain, das mit der creator verknüpft ist. Ändern Sie sie am besten in einer ruhigen Stunde und testen Sie das Brain dann im [Playground](https://lanachat.ai/guides/de/api-ai-brains/) vor der Hauptzeit.

## Setup-Fortschritt

### Die Setup-Karte abrufen

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

```bash
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`).

## Verwandte Artikel

- [LanaChat API: Schnellstart, Authentifizierung und Fehler](https://lanachat.ai/guides/de/api-overview/)
- [Eine Creatorin hinzufügen](https://lanachat.ai/guides/de/add-a-creator/)
- [Creator-Einstellungen (Persona, Preise, Sprache)](https://lanachat.ai/guides/de/creator-settings/)