> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Modellzugriff pro Benutzer

> Erlaube oder blockiere einzelne Modelle für einen bestimmten Benutzer – nur für Plattformadmins

Welche KI-Modelle verfügbar sind, entscheidet **ausschließlich der Plattformadmin** über den Modellkatalog (`models.enabled` unter `/admin/models`). Einen Override auf Workspace-Ebene gibt es nicht.

Zusätzlich zu diesem globalen Schalter kann der Plattformadmin **einzelne Modelle für einen einzelnen Benutzer** erlauben oder blockieren – praktisch für Sales-Trials, Beta-Zugänge oder gezielte Einschränkungen.

## So funktioniert's

Öffne einen Benutzer unter `/admin/users/[id]` und nutze den Bereich **Modellzugriff**. Jedes Modell im Katalog hat drei Zustände:

| Zustand   | Bedeutung                                                               |
| --------- | ----------------------------------------------------------------------- |
| `Default` | Folgt dem globalen Katalog-Schalter (`models.enabled`)                  |
| `Allow`   | Für diesen Benutzer erzwungen aktiviert, selbst wenn global deaktiviert |
| `Block`   | Für diesen Benutzer erzwungen deaktiviert, selbst wenn global aktiviert |

Die effektive Verfügbarkeit für einen Benutzer ergibt sich so: **erst der Override pro Benutzer, falls vorhanden – sonst der globale Katalog-Schalter.** Sowohl die Dropdowns im Assistenten-Editor eines Benutzers (`GET /api/models`) als auch die serverseitige Validierung beim Speichern berücksichtigen die Overrides des Assistenten-Besitzers.

<Note>
  Diese Funktion ist ausschließlich Plattformadmins vorbehalten. Weder die öffentliche v1-API noch MCP legen sie offen – nur die Admin-Endpunkte unten können sie lesen oder ändern.
</Note>

## Admin-API

Beide Endpunkte setzen einen Plattformadmin voraus (`requirePlatformAdmin`); Impersonation wird ignoriert.

**`GET /api/admin/users/{id}/models`** – liefert den vollständigen Katalog gruppiert nach Typ (`llm`/`stt`/`tts`/`realtime`). Jedes Modell enthält:

* `global_enabled` – der Katalog-Schalter
* `override` – `null` (folgt global), `true` (allow) oder `false` (block)
* `effective` – die resultierende Verfügbarkeit für diesen Benutzer

**`PUT /api/admin/users/{id}/models`** mit einem Body, der die Overrides enthält:

```json theme={null}
{ "overrides": [ { "model_id": "<uuid>", "enabled": false } ] }
```

Setze `enabled` auf `true`/`false`, um Allow/Block zu erzwingen, oder auf `null`, um den Override zu entfernen – dann folgt der Benutzer wieder dem globalen Katalog. Jede Änderung wird ins Admin-Audit-Log geschrieben.