Skip to main content
PUT
Modell-Positivliste von Devin Desktop aktualisieren

Übersicht

Ersetzt die Modell-Positivliste Ihres Teams – dieselbe Einstellung, die Administratoren in Devin Desktop unter den Organisationseinstellungen verwalten. Der Request-Body beschreibt den vollständigen Sollzustand: Die beiden Listen überschreiben die gespeicherten Listen. Damit Sie keine Änderung überschreiben, die Sie noch nicht gesehen haben, muss die Anfrage im Header If-Match das ETag einer List Models-Antwort enthalten. Haben sich die Positivliste, die verfügbaren Modelle oder deren Preise seit dieser Antwort geändert, wird das Update mit 412 abgelehnt. Rufen Sie die Modelle in diesem Fall erneut ab.
Dieser Endpunkt befindet sich in der Alpha-Phase (v2alpha). Die Struktur von Anfrage und Antwort kann sich noch ändern.

Authentifizierung

Übergeben Sie einen API-Schlüssel im Authorization-Header:
Verwenden Sie einen Devin-API-Schlüssel für Dienstbenutzer (cog_...). Zusätzlich zur Berechtigung Use Devin Desktop, die für List Models erforderlich ist, muss die Rolle des Dienstbenutzers die Berechtigung Windsurf admin (account.windsurf.admin) umfassen. Diese ist in der integrierten Rolle Account Admin enthalten. Ein Dienstbenutzer ohne diese Berechtigung kann zwar Modelle auflisten, erhält bei diesem Endpunkt jedoch den Fehler 403.

Anfrage

string
erforderlich
Der ETag-Header einer GET /api/v2alpha/models-Antwort, der den aktuellen Zustand widerspiegelt. Erforderlich; * wird nicht akzeptiert.
string[]
erforderlich
Modell-UIDs, die Nutzer auswählen dürfen, z. B. ["claude-sonnet-4-5"]. Übergeben Sie [], um Modelle ausschließlich über Tags zu erlauben.
string[]
erforderlich
Modell-Tags, die Nutzer auswählen dürfen, einschließlich Anbieter-Tags wie provider-anthropic oder provider-openai. Übergeben Sie [], um nur die aufgeführten Modell-UIDs zu erlauben.
Beide Felder sind erforderlich. Unbekannte Felder werden abgelehnt.

Beispielanfrage

Antwort

Bei Erfolg entspricht die Antwort der von List Models, jedoch mit angewendeter neuer Positivliste: jedes Modell mit seinem allowed-Flag, die gespeicherten allowed_model_uids und allowed_model_tags sowie ein neuer ETag-Header.

Fehlerantworten

Fehler werden als {"error": "<message>"} zurückgegeben.