Skip to main content
PUT
Mettre à jour la liste de modèles autorisés de Devin Desktop

Vue d’ensemble

Remplace la liste de modèles autorisés de votre équipe, c’est-à-dire le paramètre que les administrateurs gèrent dans les contrôles de l’organisation de Devin Desktop. Le corps de la requête décrit l’état complet souhaité : les deux listes remplacent celles qui sont enregistrées. Pour éviter d’écraser une modification dont vous n’avez pas connaissance, la requête doit transmettre dans l’en-tête If-Match l’ETag d’une réponse List Models. Si la liste de modèles autorisés, les modèles disponibles ou leurs tarifs ont changé depuis cette réponse, la mise à jour est rejetée avec le code 412 : listez alors à nouveau les modèles.
Cet endpoint est en version alpha (v2alpha). La structure de la requête et de la réponse est susceptible d’évoluer.

Authentification

Transmettez une clé d’API dans l’en-tête Authorization :
Utilisez une API key d’utilisateur de service Devin (cog_...). En plus de l’autorisation Use Devin Desktop requise par List Models, le rôle de l’utilisateur de service doit disposer de l’autorisation Windsurf admin (account.windsurf.admin), incluse dans le rôle intégré Account Admin. Sans cette autorisation, un utilisateur de service peut lister les modèles, mais reçoit une erreur 403 sur cet endpoint.

Requête

string
requis
L’en-tête ETag d’une réponse GET /api/v2alpha/models reflétant l’état actuel. Obligatoire ; * n’est pas accepté.
string[]
requis
UID des modèles que les utilisateurs peuvent sélectionner, p. ex. ["claude-sonnet-4-5"]. Passez [] pour autoriser les modèles uniquement par balise.
string[]
requis
Balises des modèles que les utilisateurs peuvent sélectionner, y compris les balises de fournisseur comme provider-anthropic ou provider-openai. Passez [] pour n’autoriser que les UID de modèles indiqués.
Les deux champs sont obligatoires. Les champs inconnus sont rejetés.

Exemple de requête

Réponse

En cas de succès, la réponse est identique à celle de List Models, avec la nouvelle liste d’autorisation appliquée : chaque modèle accompagné de son indicateur allowed, les valeurs enregistrées de allowed_model_uids et allowed_model_tags, ainsi qu’un nouvel en-tête ETag.

Réponses d’erreur

Les erreurs sont renvoyées sous la forme {"error": "<message>"}.