Aperçu de l'API

Bienvenue dans la documentation de l'API Minds. Notre API vous permet de créer et gérer des AI minds de manière programmatique, d'uploader des connaissances et d'interagir avec eux.

Démarrage

L'API Minds est organisée autour des principes REST. Notre API possède des URLs prévisibles orientées ressources, accepte des corps de requête encodés en JSON, renvoie des réponses encodées en JSON, et utilise les codes de réponse HTTP standards, l'authentification et les verbes HTTP classiques.

URL de base

Production : https://getminds.ai/api/v1 ou https://api.getminds.ai/v1

Développement local : http://localhost:3000/api/v1

Les deux URLs de base en production sont totalement équivalentes. Le sous-domaine api.getminds.ai est recommandé pour des URLs d'intégration plus propres.

Authentification

Tous les endpoints de l'API nécessitent une authentification via une API key. Vous pouvez générer et gérer vos API keys via Settings → API Keys.

Incluez votre API key dans l'en-tête Authorization :

Authorization: Bearer minds_your_api_key_here

Spécification OpenAPI

Une spécification OpenAPI 3.1.0 lisible par machine est publiée sur /_openapi.json. Utilisez la spécification pour générer des clients typés (TypeScript, Python, etc.) ou pour l'injecter dans un LLM afin d'obtenir du code d'intégration en une fois. Voir OpenAPI pour des exemples.

Content Type

Toutes les requêtes qui envoient des données doivent inclure l'en-tête Content-Type :

Content-Type: application/json

Pour les uploads de fichiers, utilisez :

Content-Type: multipart/form-data

Endpoints disponibles

Sparks

Créez et gérez des AI minds (agents) avec des configurations personnalisées.

• GET /api/v1/sparks - Lister tous les sparks
• GET /api/v1/sparks/{sparkId} - Obtenir les détails d'un spark
• POST /api/v1/sparks - Créer un nouveau spark
• PUT /api/v1/sparks/{sparkId} - Mettre à jour un spark
• DELETE /api/v1/sparks/{sparkId} - Supprimer un spark
• POST /api/v1/sparks/{sparkId}/regenerate-prompt - Régénérer le system prompt à partir des connaissances

Knowledge

Gérez les connaissances de vos minds.

• GET /api/v1/sparks/{sparkId}/knowledge - Lister les éléments de connaissance
• POST /api/v1/sparks/{sparkId}/knowledge - Ajouter des connaissances (liens, fichiers ou recherche par mots-clés)
• PUT /api/v1/sparks/{sparkId}/knowledge/{itemId} - Mettre à jour un élément de connaissance
• DELETE /api/v1/sparks/{sparkId}/knowledge/{itemId} - Supprimer un élément de connaissance
• POST /api/v1/sparks/{sparkId}/knowledge/enrich - Enrichir via recherche par mots-clés (alias pratique)
• GET /api/v1/sparks/{sparkId}/knowledge/patterns - Obtenir les patterns de connaissance par framework

Chat

Interagissez avec vos minds via des chat completions.

• POST /api/v1/sparks/{sparkId}/completion - Envoyer des messages et recevoir des réponses

Panels

Créez et gérez des AI panels pour interroger des groupes de minds.

• GET /api/v1/panels - Lister tous les panels
• POST /api/v1/panels - Créer un nouveau panel
• GET /api/v1/panels/{panelId} - Obtenir les détails d'un panel avec l'historique des messages
• POST /api/v1/panels/{panelId}/ask - Poser une question à tous les minds du panel (flux SSE)
• POST /api/v1/panels/{panelId}/export - Exporter les résultats du panel sous forme de rapport
• GET /api/v1/panels/{panelId}/export-status - Vérifier le statut du job d'export
• GET /api/v1/panels/{panelId}/export-download - Télécharger le PDF exporté

User

Endpoints liés à l'utilisateur.

• GET /api/v1/auth/me - Obtenir l'utilisateur actuellement authentifié
• GET /api/v1/user/shareable-sparks - Lister les minds disponibles au partage

API Keys

Gérez vos API keys pour l'authentification.

• GET /api/v1/api-keys - Lister vos API keys
• POST /api/v1/api-keys - Créer une nouvelle API key
• DELETE /api/v1/api-keys/{keyId} - Supprimer une API key

Exemple rapide

Voici un exemple rapide de création d'un mind puis d'une conversation avec lui :

# 1. Créer un mind (mode keywords)
curl -X POST "https://getminds.ai/api/v1/sparks" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Marketing Expert",
    "description": "Expert in digital marketing strategies",
    "mode": "keywords",
    "type": "expert",
    "discipline": "Marketing",
    "keywords": ["SEO", "content marketing", "social media", "analytics"]
  }'

# Response: { "data": { "id": "spark-id", ... }, "processing": { "queued": true, ... } }

# 2. Créer un mind à partir d'un profil social (mode clone)
curl -X POST "https://getminds.ai/api/v1/sparks" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Influencer Clone",
    "description": "AI trained on influencer social presence",
    "mode": "clone",
    "type": "creative",
    "discipline": "Social Media Marketing",
    "personaContext": "https://twitter.com/username"
  }'

# 3. Discuter avec le mind
curl -X POST "https://getminds.ai/api/v1/sparks/spark-id/completion" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "role": "user",
        "content": "What are the top social media trends for 2025?"
      }
    ]
  }'

Étapes suivantes

• Découvrez l'Authentification
• Explorez les endpoints Sparks
• Lisez la gestion des connaissances
• Comprenez les Chat completions
• Créez des Panels pour des enquêtes multi-minds
• Consultez Latency & Performance
• Connectez-vous via l'intégration MCP
• Consultez Errors & Limits

Limites selon l'offre

L'utilisation de l'API est soumise à votre plan d'abonnement :

Voir les offres

Besoin d'aide ?

Si vous avez des questions ou besoin d'aide avec l'API :

• Consultez notre Guide
• Contactez-nous via le formulaire de feedback
• Rejoignez nos discussions communautaires