---
title: "API REST"
url: "https://raconte.ai/fr/docs/api"
---

### Documentation

[Introduction](/fr/docs)[Démarrer](/fr/docs/getting-started)[Serveur MCP](/fr/docs/mcp)[Webhooks](/fr/docs/webhooks)[API REST](/fr/docs/api)[CLI](/fr/docs/cli)[SDK](/fr/docs/sdk)[Skill agent](/fr/docs/skill)

### Guides

[Configurer le serveur MCP](/fr/guides/mcp-setup)[Utiliser le serveur MCP](/fr/guides/mcp-usage)

[Raconte](/) ⟩ [Documentation](/fr/docs)

# API REST

Gérez interviews et invitations en HTTP avec une clé d'API d'organisation.

Raconte expose une API REST pour gérer les **interviews** et les **invitations** directement en HTTP. C’est la même surface que pilote le [serveur MCP](/fr/docs/mcp), accessible depuis n’importe quel client HTTP. Utilisez MCP pour qu’un agent IA opère le produit, et l’API REST pour intégrer depuis votre propre backend. Pour le terminal et les scripts, utilisez le [CLI](/fr/docs/cli) ; pour une application TypeScript ou Node, le [SDK](/fr/docs/sdk).

La référence complète et interactive (chaque endpoint, paramètre, schéma, avec un “essayer” intégré) se trouve ici :

[Ouvrir la référence API interactive →](/fr/docs/api-reference)

## URL de base

```
https://api.raconte.ai
```

Chaque chemin est préfixé par `/api`, par exemple `https://api.raconte.ai/api/interviews`.

## Authentification

L’authentification utilise une clé d’API d’organisation, créée depuis [Paramètres → API](/settings/api) dans l’application et limitée à une organisation. Chaque requête s’exécute dans le périmètre de cette organisation ; les ressources des autres organisations ne sont jamais renvoyées.

Passez la clé en tant que jeton Bearer :

```
Authorization: Bearer VOTRE_CLE_API
```

Un en-tête `x-api-key: VOTRE_CLE_API` est également accepté.

```
curl https://api.raconte.ai/api/interviews \
  -H "Authorization: Bearer VOTRE_CLE_API"
```

## Ce que vous pouvez faire

*   **Interviews** : créer, lister, lire, modifier, archiver/restaurer, régénérer l’intro ou le premier message, et lire les journaux d’activité.
*   **Invitations** : créer (unitaire ou en masse), lister, lire, modifier, envoyer, annuler, réactiver, archiver/restaurer, lire les journaux, et obtenir une URL audio signée pour un message.

Les opérations au niveau du compte (facturation, webhooks, gestion des clés d’API, réglages de l’organisation) ne sont **pas** accessibles via les clés d’API : elles restent dans l’application authentifiée.

Consultez la [référence interactive](/fr/docs/api-reference) pour tous les schémas de requête et de réponse.

Sommaire

[1\. URL de base](#url-de-base)[2\. Authentification](#authentification)[3\. Ce que vous pouvez faire](#ce-que-vous-pouvez-faire)