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

Minds

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

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

Knowledge

Verwalten Sie das Wissen Ihrer Minds.

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

Chat

Interagieren Sie mit Ihren Minds über Chat Completions.

• POST /api/v1/minds/{mindId}/completion - Nachrichten senden und Antworten erhalten

Studies

Erstellen und verwalten Sie KI-Studies, um Audiences von Minds zu befragen.

• GET /api/v1/studies - Alle Studies auflisten
• POST /api/v1/studies - Neues Study erstellen
• GET /api/v1/studies/{studyId} - Study-Details inklusive Nachrichtenverlauf abrufen
• POST /api/v1/studies/{studyId}/ask - Eine Frage an alle Study-Minds stellen (SSE-Stream)
• POST /api/v1/studies/{studyId}/export - Study-Ergebnisse als Report exportieren
• GET /api/v1/studies/{studyId}/export-status - Status des Export-Jobs prüfen
• GET /api/v1/studies/{studyId}/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/minds" \
  -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": "mind-id", ... }, "processing": { "queued": true, ... } }

# 2. Einen Mind aus einem Social-Profil erstellen (clone-Modus)
curl -X POST "https://getminds.ai/api/v1/minds" \
  -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/minds/mind-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 Minds-Endpoints
• Lesen Sie über Knowledge-Management
• Verstehen Sie Chat Completions
• Erstellen Sie Studies für Multi-Mind-Umfragen
• Prüfen Sie Latency & Performance
• Verbinden Sie sich per MCP-Integration
• Prüfen Sie Errors & Limits

Plan-Limits

Der API- und MCP-Zugriff ist in unterstützten kostenpflichtigen Plänen verfügbar. Verarbeiten Sie strukturierte plan_limited- und 429-Antworten, statt Limits in Ihrer Integration fest zu codieren. Der Individual-Plan wird in API-Payloads als "premium" ausgegeben.

Die folgenden öffentlichen Standardwerte werden aus demselben Plan-Limit- und Feature-Access-Vertrag wie das Produkt generiert. Konto- und Enterprise-spezifische Overrides, die im Produkt angezeigt werden, haben Vorrang.

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