Authentifizierung

Die Minds-Forschungs-API benötigt einen API-Schlüssel oder eine genehmigte OAuth-Berechtigung. Öffentliche Seiten und Discovery-Dokumente sind ohne Anmeldung lesbar.

API key erhalten

1. Melden Sie sich bei Ihrem Minds-Account an
2. Navigieren Sie zu Settings → API Keys
3. Klicken Sie auf Generate New API Key
4. Kopieren Sie Ihren API key sofort (Sie werden ihn später nicht mehr sehen können!)

API keys haben den Präfix minds_ und sehen so aus: minds_0000111122223333444455556666777788889999aaaabbbb

API key verwenden

Binden Sie Ihren API key im Authorization-Header jeder Anfrage ein:

Authorization: Bearer minds_your_api_key_here

Beispiel-Request

curl -X GET "https://getminds.ai/api/v1/api-keys" \
  -H "Authorization: Bearer minds_your_api_key"

Best Practices zur Sicherheit

Halten Sie Ihre Keys geheim

• Niemals API keys in Version Control committen
• Niemals Keys in öffentlichen Foren oder Chats teilen
• Keys in Umgebungsvariablen oder sicheren Vaults speichern
• Keys regelmäßig aus Sicherheitsgründen rotieren

Umgebungsvariablen verwenden

# Key als Umgebungsvariable setzen
export MINDS_API_KEY="minds_your_api_key_here"

# In Requests verwenden
curl -X GET "https://getminds.ai/api/v1/api-keys" \
  -H "Authorization: Bearer $MINDS_API_KEY"

Keys regelmäßig rotieren

Wenn Sie vermuten, dass ein Key kompromittiert wurde:

1. Neuen API key generieren
2. Ihre Anwendungen auf den neuen Key umstellen
3. Alten Key löschen

API keys verwalten

Ihre API keys auflisten

GET /api/v1/api-keys

Gibt eine Liste Ihrer API keys mit Metadaten zurück (die tatsächlichen Key-Werte werden nie zurückgegeben):

[
  {
    "id": "key-id",
    "name": "prod",
    "createdAt": "2025-12-10T12:00:00.000Z",
    "lastUsedAt": "2025-12-10T13:00:00.000Z"
  }
]

Neuen API key erstellen

POST /api/v1/api-keys

Headers:

Content-Type: application/json

Request Body (optional):

{
  "name": "prod"
}

Das optionale Feld name ist eine lesbare Beschriftung für den Key (String, 1–100 Zeichen). Sie hilft beim Identifizieren von Keys in der List-Antwort und im Settings-UI. Whitespace wird getrimmt; ein leerer oder fehlender Wert wird als null gespeichert. Ein leerer Request Body wird akzeptiert und erzeugt einen unbenannten Key.

Die Response enthält den tatsächlichen Key (einziger Zeitpunkt, an dem Sie ihn sehen):

{
  "id": "new-key-id",
  "name": "prod",
  "key": "minds_0000111122223333444455556666777788889999aaaabbbb",
  "createdAt": "2025-12-10T12:00:00.000Z"
}

Beispiel mit name

curl -X POST "https://getminds.ai/api/v1/api-keys" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name":"prod"}'

⚠️ Wichtig: Speichern Sie den key-Wert sofort! Sie werden ihn später nicht mehr abrufen können.

API key löschen

DELETE /api/v1/api-keys/{keyId}

Bei Erfolg wird 204 No Content mit leerem Body zurückgegeben.

Authentifizierungsfehler

401 Unauthorized

Ihr API key fehlt oder ist ungültig.

{
  "statusCode": 401,
  "statusMessage": "Unauthorized",
  "message": "Invalid or missing API key"
}

Lösungen:

• Prüfen Sie, ob Sie den Authorization-Header eingebunden haben
• Verifizieren Sie, dass Ihr API key korrekt ist
• Stellen Sie sicher, dass Sie das Präfix Bearer verwenden
• Generieren Sie einen neuen Key, falls der alte gelöscht wurde

Plan-basierter Zugriff

API-Zugriff ist eine unterstützte Paid-Plan-Funktion und unterliegt den im Produkt angezeigten oder vertraglich vereinbarten Ressourcen-, Antwort- und Workspace-Limits. Limits nicht fest einprogrammieren, sondern strukturierte PLAN_LIMIT- und plan_limited-Antworten behandeln. Der Starter-Plan erscheint in API-Payloads als "premium".

Pläne ansehen

Agenten mit Lesezugriff

Ein Agent kann über auth.md Lesezugriff anfordern. Melden Sie sich mit dem vorgesehenen verifizierten Konto an, geben Sie den sechsstelligen Code Ihres Agenten ein und genehmigen Sie die angezeigten Berechtigungen. Die Anfrage läuft nach zehn Minuten ab.

Die erste Registrierungsberechtigung erlaubt nur die Abfrage ihres eigenen Status. Nach der Zustimmung erhält der Agent ein eingeschränktes OAuth-Token zum Lesen unterstützter Minds, Zielgruppen und Studien. Er kann keine Forschung ändern, kostenpflichtige Arbeit starten, API-Schlüssel erstellen oder Ihr Konto verwalten. Entfernen Sie die OAuth-Verbindung in den Einstellungen, um den Zugriff zu widerrufen.

Für MCP gelten die Ressourcenmetadaten. Die Metadaten öffentlicher Seiten enthalten keine erforderlichen Leseberechtigungen.