# API reference

> Every route of the public API, generated from the OpenAPI 3.1 contract.

URL : https://docs.fanconvert.ai/en/api/reference

{/* Généré par scripts/generer-reference.mjs : ne pas modifier à la main. */}

This reference is generated on every site build from [the OpenAPI 3.1 contract](https://app.fanconvert.ai/public/v1/openapi.json) served by the API, so it cannot drift from what the API accepts. Descriptions come from the contract and are written in French. Base URL: `https://app.fanconvert.ai/public/v1`.

## Routes [#routes]

- [API key](/en/api/reference/cle-api)
  - `GET /public/v1/me` — La clé utilisée
- [Creators](/en/api/reference/creatrices)
  - `GET /public/v1/creators` — Les créatrices de la clé
  - `GET /public/v1/creators/{creator_id}` — Une créatrice
- [Conversations](/en/api/reference/conversations)
  - `GET /public/v1/creators/{creator_id}/conversations` — Les conversations d'une créatrice
  - `GET /public/v1/creators/{creator_id}/conversations/{conversation_id}/messages` — Les messages d'une conversation
- [Fans](/en/api/reference/fans)
  - `GET /public/v1/creators/{creator_id}/labels` — Les étiquettes de fans d'une créatrice
  - `GET /public/v1/creators/{creator_id}/fans/{conversation_id}` — La fiche d'un fan : étiquettes et note de l'équipe
  - `PUT /public/v1/creators/{creator_id}/fans/{conversation_id}/note` — Écrire la note de l'équipe sur un fan
  - `PUT /public/v1/creators/{creator_id}/fans/{conversation_id}/labels/{label_id}` — Poser une étiquette sur un fan (sans effet si elle y est déjà)
  - `DELETE /public/v1/creators/{creator_id}/fans/{conversation_id}/labels/{label_id}` — Retirer une étiquette d'un fan
- [AI](/en/api/reference/ia)
  - `GET /public/v1/creators/{creator_id}/conversations/{conversation_id}/ai` — Qui répond à ce fan : l'IA, une personne, ou personne
  - `POST /public/v1/creators/{creator_id}/conversations/{conversation_id}/ai/pause` — Mettre l'IA en pause sur ce fan (« Arrêter le chatting »), MYM
  - `POST /public/v1/creators/{creator_id}/conversations/{conversation_id}/ai/resume` — Rendre ce fan à l'IA (« Relancer le chatting »), MYM
- [Sales and statistics](/en/api/reference/ventes-et-statistiques)
  - `GET /public/v1/sales` — Les ventes, par plateforme
  - `GET /public/v1/statistics/creators` — Revenus et envois par créatrice sur une période
- [Scripts and media](/en/api/reference/scripts-et-medias)
  - `GET /public/v1/creators/{creator_id}/scripts` — Les scripts de vente d'une créatrice
  - `GET /public/v1/creators/{creator_id}/media` — La médiathèque d'une créatrice
- [Emergencies](/en/api/reference/urgences)
  - `GET /public/v1/emergencies` — Les urgences : ce qui attend un humain
- [Webhooks](/en/api/reference/webhooks)
  - `POST /public/v1/webhooks` — Enregistrer une adresse qui recevra les événements
  - `GET /public/v1/webhooks` — Les webhooks de cette clé
  - `DELETE /public/v1/webhooks/{endpoint_id}` — Désactiver un webhook (son journal est gardé)
  - `GET /public/v1/webhooks/{endpoint_id}/deliveries` — Le journal des livraisons, les plus récentes d'abord
  - `POST /public/v1/webhooks/{endpoint_id}/ping` — Envoyer un événement `ping` (aucune donnée) pour tester la réception