API REST

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, 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 ; pour une application TypeScript ou Node, le 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 →

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 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 pour tous les schémas de requête et de réponse.