---
title: "Référence de l'API"
description: "Les endpoints de l'API publique — avec un lien vers le document OpenAPI lisible par une machine."
slug: "fr/developers/api-reference"
url: "https://docs.custom.one/fr/developers/api-reference/"
capability: "integrations"
published_at: "2026-09-08T13:06:30.957Z"
---
Authentifiez chaque requête avec une clé API de workspace, dans l'un ou l'autre
en-tête :

```
Authorization: Bearer <clé>
X-API-Key: <clé>
```

Le préfixe de la clé choisit l'hôte — `co_live_…` → `https://api.custom.one`,
`co_test_…` → `https://dev.api.custom.one`. Tous les chemins sont sous `/api/v1`.

## Endpoints

Groupés par ce que vous faites. Cette table est un index — le **contrat**, c'est
le document OpenAPI en bas de page, généré depuis l'API elle-même, et un contrôle
au build échoue si les deux divergent.

### Authentification

| Méthode & chemin | Rôle |
|---|---|
| `GET /me` | Tester l'authentification, et identifier le workspace de la clé. |

### Customs — lecture

| Méthode & chemin | Rôle |
|---|---|
| `GET /funnels` | Lister les customs du workspace. Paginé par curseur. |
| `GET /funnels/:id` | Un custom : ses pointeurs de version et son lien vers l'éditeur. |
| `GET /templates` | Les modèles clonables. |
| `GET /funnels/:id/fields` | Les colonnes mappables d'un custom. |
| `GET /funnels/:id/readiness` | Ce qu'il reste avant publication, sans rien publier. |
| `GET /funnels/:id/questions` | Les questions du brouillon. |
| `GET /funnels/:id/scores` | Les scores du brouillon. |
| `GET /funnels/:id/segments` | Les scènes : quels clips existent et quand ils jouent. |

### Customs — construire et publier

| Méthode & chemin | Rôle |
|---|---|
| `POST /funnels` | Créer un custom, éventuellement cloné d'un modèle. Toujours un brouillon. |
| `PATCH /funnels/:id/questions` | REMPLACER l'ensemble des questions. |
| `PATCH /funnels/:id/scores` | REMPLACER l'ensemble des scores. |
| `PATCH /funnels/:id/segments` | REMPLACER les scènes. Vous définissez la structure, jamais les images. |
| `POST /funnels/:id/clip-scripts` | Écrire les textes à lire face caméra. |
| `POST /funnels/:id/pages/:pageSlug/html-blocks` | Poser des blocs HTML personnalisés sur une page de résultat, et récupérer un lien montrant le rendu. Pose seulement — le HTML, c'est vous qui l'écrivez. |
| `POST /funnels/:id/result-page-previews` | Voir une page de résultat draft pour un jeu de réponses, sans publier. Renvoie un lien qui expire. |
| `POST /funnels/:id/publish` | Mettre le brouillon en ligne. Refuse tant qu'il manque quelque chose. |
| `DELETE /funnels/:id` | Mettre un custom à la corbeille. Réversible — il reste récupérable depuis le dashboard. |

### Leads

| Méthode & chemin | Rôle |
|---|---|
| `GET /leads` | Lister les leads, du plus récent au plus ancien. Paginé par curseur. |
| `POST /leads` | Créer un lead. Accepte un en-tête `Idempotency-Key`. |
| `PATCH /leads/:id` | Modifier un lead — marquer acheteur, ajouter une note. |
| `GET /leads/sample` | Quelques leads récents, au format de l'événement `diagnostic.submitted`. |
| `GET /tags` | Lister les tags du workspace. |
| `POST /leads/:id/tags` | Ajouter des tags au contact d'un lead. |
| `DELETE /leads/:id/tags` | Retirer des tags du contact d'un lead. |

### Sources entrantes

| Méthode & chemin | Rôle |
|---|---|
| `POST /sources` | Créer une entrée par custom. Renvoie l'URL d'ingestion prête à coller. |
| `GET /sources` | Lister les sources entrantes d'un custom (jamais le secret). |
| `GET /sources/:id` | Une source entrante (jamais le secret). |
| `PATCH /sources/:id` | Modifier le nom, le mapping, l'état actif ou l'auto-soumission. |
| `DELETE /sources/:id` | Supprimer une source. Les lignes déjà produites sont conservées. |
| `GET /sources/:id/secret` | Reconstruire l'URL d'ingestion d'une source existante. |
| `POST /sources/:id/rotate-secret` | Générer un nouveau secret. L'ancienne URL cesse immédiatement. |
| `POST /sources/:id/import` | Importer un CSV en lignes EN ATTENTE. Rien n'est facturé tant qu'elles ne sont pas soumises. |

### Webhooks sortants

| Méthode & chemin | Rôle |
|---|---|
| `POST /hooks` | S'abonner à des événements de lead. |
| `GET /hooks` | Lister les abonnements créés par l'API. |
| `PATCH /hooks/:id` | Modifier un abonnement sur place — URL, événements, périmètre. |
| `DELETE /hooks/:id` | Se désabonner. |

## Référence complète

Le contrat complet et lisible par une machine — chaque paramètre, schéma de
réponse et erreur — est le document OpenAPI, généré depuis l'API elle-même :

- [`/openapi/public-openapi.json`](/openapi/public-openapi.json)

Pointez votre générateur de code ou votre agent IA sur cette URL. Un explorateur
interactif rendu arrivera.