API : créatrices, identité et persona

Lecture de 6 minMis à jour 22 oct. 2026Markdown

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 #

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

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
}

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

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

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

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

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

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

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

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

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

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

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

Astuce La persona alimente chaque brain lié à la créatrice. Modifiez-la à une heure creuse, puis testez le brain dans le Playground avant les pics d’activité.

Setup progress #

Obtenir la carte Setup #

GET /creators/{id}/setup · can_setup

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