# API : créatrices, identité et persona

_API · Lecture de 6 min · Mis à jour 2026-10-22 · https://lanachat.ai/guides/fr/api-creators/_

Une **creator** est une personne que votre agence gère sur Telegram. Elle possède une **identity** (qui elle est), une **persona** (sa façon de parler, en huit pages) et des liens vers ses comptes Telegram, son AI Brain, son Vault et ses scripts. Ces endpoints correspondent à la page **Creators** de la Console.

## Endpoints

| Method | Path | Description | Permission | Status |
|---|---|---|---|---|
| GET | `/creators` | Lister les créatrices (`status=active,paused,archived`, `q=` recherche par nom) | `can_setup` ou `can_fan_read` | Planned |
| POST | `/creators` | Créer une créatrice (nom obligatoire) | `can_setup` | Planned |
| GET | `/creators/{id}` | Une créatrice avec sa progression de configuration | `can_setup` ou `can_fan_read` | Planned |
| PATCH | `/creators/{id}` | Renommer, changer sa photo, son fuseau horaire ou le brain lié | `can_setup` | Planned |
| POST | `/creators/{id}/pause` | Mettre en pause : l’IA arrête de répondre sur tous ses comptes | `can_setup` | Planned |
| POST | `/creators/{id}/resume` | Reprendre une créatrice en pause | `can_setup` | Planned |
| DELETE | `/creators/{id}` | Archiver (ses fans et ventes sont conservés) | `can_setup` | Planned |
| GET | `/creators/{id}/identity` | Sa carte d’identité | `can_setup` | Planned |
| PUT | `/creators/{id}/identity` | Remplacer sa carte d’identité | `can_setup` | Planned |
| GET | `/creators/{id}/persona` | Les huit pages de persona et leur complétion | `can_engine` | Planned |
| PATCH | `/creators/{id}/persona` | Modifier une ou plusieurs pages de persona | `can_engine` | Planned |
| GET | `/creators/{id}/setup` | La carte Setup : chaque étape et son statut | `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 | Commence par `cr_` |
| `name` | string | Son nom dans la Console |
| `status` | string | `active`, `paused` ou `archived` |
| `photo_url` | string ou null | Sa photo |
| `timezone` | string | Fuseau horaire IANA, par exemple `Europe/Paris` |
| `brain_id` | string ou null | L’AI Brain lié à la créatrice |
| `accounts` | object | Nombre de ses comptes Telegram : `total`, `connected` |
| `setup` | object | Étapes de la carte Setup : `done` sur `total` |
| `created_at`, `updated_at` | string | ISO 8601, UTC |

Une créatrice en pause garde ses comptes connectés mais l’IA ne répond plus ; les scripts déjà lancés s’arrêtent à leur prochaine étape.

## Creators

### Lister les créatrices

`GET /creators` · `can_setup` ou `can_fan_read`

| Parameter | Type | Required | Description |
|---|---|---|---|
| `status` | string | Non | `active`, `paused` ou `archived` ; plusieurs séparés par des virgules |
| `q` | string | Non | Partie de son nom |
| `limit`, `cursor` | number, string | Non | [Pagination](https://lanachat.ai/guides/fr/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
}
```

### Créer une créatrice

`POST /creators` · `can_setup`

| Parameter | Type | Required | Description |
|---|---|---|---|
| `name` | string | Oui | Son nom dans la Console |
| `timezone` | string | Non | Fuseau horaire 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"
}
```

La réponse est la nouvelle créatrice (`201`). Elle commence avec une identité et une persona vides, aucun compte et aucun brain : le compteur `setup` montre ce qu’il reste à faire, comme la carte Setup dans la Console. Si le `name` est absent, la réponse est `400`.

### Obtenir une créatrice

`GET /creators/{id}` · `can_setup` ou `can_fan_read`

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

La réponse est l’objet créatrice. Un id inconnu donne `404`.

### Mettre à jour une créatrice

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| `name` | string | Non | Nouveau nom |
| `timezone` | string | Non | Fuseau horaire IANA |
| `brain_id` | string ou null | Non | Le brain à lier ; `null` le retire |

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

La réponse est la créatrice mise à jour. Un `brain_id` d’un autre workspace donne `404`.

### Pause et reprise

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

La pause coupe l’IA sur tous ses comptes d’un coup ; `resume` la réactive. Les deux renvoient l’objet créatrice avec son nouveau statut.

### Archiver une créatrice

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

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

La réponse est la créatrice avec `status: "archived"`. Ses fans et ventes sont conservés et restent comptabilisés dans vos stats.

## Identity

### Obtenir l’identité

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

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

La réponse contient les mêmes champs que l’identité ci-dessous.

### Remplacer l’identité

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| `first_name` | string | Non | Son prénom, tel que les fans le connaissent |
| `nicknames` | array of strings | Non | Petits noms auxquels elle répond |
| `date_of_birth` | string | Non | `YYYY-MM-DD` ; elle doit avoir 18 ans ou plus |
| `nationality` | string | Non | Code pays à deux lettres, par exemple `FR` |
| `languages` | array of strings | Non | Langues parlées, par exemple `["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` est calculé à partir de la date de naissance. Une créatrice de moins de 18 ans est refusée (`400`). `PUT` remplace toute la carte : un champ omis est vidé.

## Persona

La persona comporte les mêmes huit pages que dans la Console : `appearance`, `life`, `voice`, `mimic`, `personality`, `memory`, `boundaries`, `examples`. Chaque page est un objet de champs texte ; `PATCH` ne modifie que les pages envoyées.

### Obtenir la persona

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

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

La réponse a la même structure qu’en dessous, avec les huit pages.

### Modifier des pages de persona

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| `appearance`, `life`, `voice`, `mimic`, `personality`, `memory`, `boundaries`, `examples` | object | Au moins un | Les pages à modifier ; les autres restent |

```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: La persona alimente chaque brain lié à la créatrice. Modifiez-la à une heure creuse, puis testez le brain dans le [Playground](https://lanachat.ai/guides/fr/api-ai-brains/) avant les pics d’activité.

## Setup progress

### Obtenir la carte Setup

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

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

La réponse liste chaque étape de la carte Setup de la Console et si elle est faite. `setup` dans l’objet créatrice correspond à cette progression sous forme de compteur (`done` sur `total`).

## Articles liés

- [API LanaChat : démarrage rapide, authentification et erreurs](https://lanachat.ai/guides/fr/api-overview/)
- [Ajouter une créatrice](https://lanachat.ai/guides/fr/add-a-creator/)
- [Paramètres de la créatrice (persona, tarifs, langue)](https://lanachat.ai/guides/fr/creator-settings/)