---
title: "API-Übersicht"
description: "Einführung in die Minds API für den programmatischen Zugriff auf Minds und Knowledge-Management."
---

# 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](/settings/api-keys) erzeugen und verwalten.

Binden Sie Ihren API key im `Authorization`-Header ein:

```bash
Authorization: Bearer minds_your_api_key_here
```

### OpenAPI Spec

Eine maschinenlesbare OpenAPI-3.1.0-Spezifikation wird unter [`/_openapi.json`](/_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](/docs/api/openapi) für Beispiele.

### Content Type

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

```bash
Content-Type: application/json
```

Für Datei-Uploads verwenden Sie:

```bash
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:

```bash
# 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](/docs/api/authentication)
- Entdecken Sie die [Minds-Endpoints](/docs/api/minds)
- Lesen Sie über [Knowledge-Management](/docs/api/knowledge)
- Verstehen Sie [Chat Completions](/docs/api/chat)
- Erstellen Sie [Studies](/docs/api/studies) für Multi-Mind-Umfragen
- Prüfen Sie [Latency & Performance](/docs/api/latency)
- Verbinden Sie sich per [MCP-Integration](/mcp/overview)
- Prüfen Sie [Errors & Limits](/docs/api/errors)

## 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.

:plan-limits-table[Pläne ansehen](/settings?tab=subscription)

## Hilfe benötigt?

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

- Sehen Sie sich unseren [Guide](/guide) an
- Kontaktieren Sie uns über das Feedback-Formular
- Nehmen Sie an unseren Community-Diskussionen teil