API-Übersicht

Willkommen zur Dokumentation der Minds API. Unsere API ermöglicht es Ihnen, KI-Minds programmatisch zu erstellen und zu verwalten, Wissen hochzuladen und mit ihnen zu interagieren.

Erste Schritte

Die Minds API ist nach REST-Prinzipien aufgebaut. Unsere API verwendet vorhersehbare, ressourcenorientierte URLs, akzeptiert JSON-codierte Request-Bodies, liefert JSON-codierte Responses und nutzt standardmäßige HTTP-Statuscodes, Authentifizierung und Verben.

Base URL

Produktion: https://getminds.ai/api/v1 oder https://api.getminds.ai/v1

Lokale Entwicklung: http://localhost:3000/api/v1

Beide produktiven Base URLs sind vollständig gleichwertig. Für saubere Integrations-URLs empfehlen wir die Subdomain api.getminds.ai.

Authentifizierung

Alle API-Endpoints erfordern eine Authentifizierung per API key. Sie können Ihre API keys unter Settings → API Keys erzeugen und verwalten.

Binden Sie Ihren API key im Authorization-Header ein:

Authorization: Bearer minds_your_api_key_here

OpenAPI Spec

Eine maschinenlesbare OpenAPI-3.1.0-Spezifikation wird unter /_openapi.json veröffentlicht. Nutze die Spezifikation, um typisierte Clients (TypeScript, Python usw.) zu generieren oder sie für One-Shot-Integrationscode in ein LLM einzugeben. Siehe OpenAPI für Beispiele.

Content Type

Alle Requests, die Daten senden, sollten den Content-Type-Header enthalten:

Content-Type: application/json

Für Datei-Uploads verwenden Sie:

Content-Type: multipart/form-data

Verfügbare Endpoints

Sparks

Erstellen und verwalten Sie KI-Minds (Agenten) mit individuellen Konfigurationen.

• GET /api/v1/sparks - Alle Sparks auflisten
• GET /api/v1/sparks/{sparkId} - Spark-Details abrufen
• POST /api/v1/sparks - Neuen Spark erstellen
• PUT /api/v1/sparks/{sparkId} - Spark aktualisieren
• DELETE /api/v1/sparks/{sparkId} - Spark löschen
• POST /api/v1/sparks/{sparkId}/regenerate-prompt - System Prompt aus Wissen neu generieren
• GET /api/v1/sparks/{sparkId}/patterns - Rohe Denkmuster eines Sparks abrufen

Knowledge

Verwalten Sie das Wissen Ihrer Minds.

• GET /api/v1/sparks/{sparkId}/knowledge - Knowledge-Einträge auflisten
• POST /api/v1/sparks/{sparkId}/knowledge - Wissen hinzufügen (Links, Dateien oder Keyword-Suche)
• PUT /api/v1/sparks/{sparkId}/knowledge/{itemId} - Knowledge-Eintrag aktualisieren
• DELETE /api/v1/sparks/{sparkId}/knowledge/{itemId} - Knowledge-Eintrag löschen
• POST /api/v1/sparks/{sparkId}/knowledge/enrich - Anreicherung per Keyword-Suche (Convenience-Alias)
• GET /api/v1/sparks/{sparkId}/knowledge/patterns - Wissensmuster nach Framework abrufen

Chat

Interagieren Sie mit Ihren Minds über Chat Completions.

• POST /api/v1/sparks/{sparkId}/completion - Nachrichten senden und Antworten erhalten

Panels

Erstellen und verwalten Sie KI-Panels, um Gruppen von Minds zu befragen.

• GET /api/v1/panels - Alle Panels auflisten
• POST /api/v1/panels - Neues Panel erstellen
• GET /api/v1/panels/{panelId} - Panel-Details inklusive Nachrichtenverlauf abrufen
• POST /api/v1/panels/{panelId}/ask - Eine Frage an alle Panel-Minds stellen (SSE-Stream)
• POST /api/v1/panels/{panelId}/export - Panel-Ergebnisse als Report exportieren
• GET /api/v1/panels/{panelId}/export-status - Status des Export-Jobs prüfen
• GET /api/v1/panels/{panelId}/export-download - Exportiertes PDF herunterladen

User

Benutzerbezogene Endpoints.

• GET /api/v1/auth/me - Aktuell authentifizierten Benutzer abrufen
• GET /api/v1/user/shareable-sparks - Minds auflisten, die zum Teilen verfügbar sind

API Keys

Verwalten Sie Ihre API keys für die Authentifizierung.

• GET /api/v1/api-keys - Ihre API keys auflisten
• POST /api/v1/api-keys - Neuen API key erstellen
• DELETE /api/v1/api-keys/{keyId} - API key löschen

Schnellbeispiel

Hier ist ein kurzes Beispiel, das einen Mind erstellt und mit ihm chattet:

# 1. Einen Mind erstellen (keywords-Modus)
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. Einen Mind aus einem Social-Profil erstellen (clone-Modus)
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. Mit dem Mind chatten
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?"
      }
    ]
  }'

Nächste Schritte

• Erfahren Sie mehr über Authentifizierung
• Entdecken Sie die Sparks-Endpoints
• Lesen Sie über Knowledge-Management
• Verstehen Sie Chat Completions
• Erstellen Sie Panels für Multi-Mind-Umfragen
• Prüfen Sie Latency & Performance
• Verbinden Sie sich per MCP-Integration
• Prüfen Sie Errors & Limits

Plan-Limits

Die API-Nutzung hängt von Ihrem Abonnement-Plan ab:

Pläne ansehen

Hilfe benötigt?

Wenn Sie Fragen haben oder Unterstützung zur API benötigen:

• Sehen Sie sich unseren Guide an
• Kontaktieren Sie uns über das Feedback-Formular
• Nehmen Sie an unseren Community-Diskussionen teil