Skip to main content
PUT
Aggiornare l'elenco di elementi consentiti dei modelli di Devin Desktop

Panoramica

Sostituisce l’elenco di elementi consentiti dei modelli del tuo team, ovvero la stessa impostazione che gli amministratori gestiscono nei controlli dell’organizzazione in Devin Desktop. Il corpo della richiesta rappresenta lo stato desiderato completo: i due elenchi sostituiscono quelli salvati. Per evitare di sovrascrivere una modifica che non hai ancora visto, la richiesta deve includere nell’intestazione If-Match l’ETag di una risposta di List Models. Se da quella risposta sono cambiati l’elenco di elementi consentiti dei modelli, i modelli disponibili o i relativi prezzi, l’aggiornamento viene rifiutato con 412 e dovrai elencare di nuovo i modelli.
Questo endpoint è in fase alpha (v2alpha). La struttura della richiesta e della risposta potrebbe cambiare.

Autenticazione

Passa una chiave API nell’intestazione Authorization:
Usa una API key dell’utente di servizio di Devin (cog_...). Oltre all’autorizzazione Use Devin Desktop richiesta da List Models, il ruolo dell’utente di servizio deve includere l’autorizzazione Windsurf admin (account.windsurf.admin), già prevista dal ruolo integrato Account Admin. Un utente di servizio privo di questa autorizzazione può elencare i modelli, ma riceve un errore 403 su questo endpoint.

Richiesta

string
obbligatorio
Il valore dell’intestazione ETag di una risposta GET /api/v2alpha/models che riflette lo stato attuale. Obbligatorio; * non è accettato.
string[]
obbligatorio
UID dei modelli che gli utenti possono selezionare, ad es. ["claude-sonnet-4-5"]. Passa [] per consentire i modelli solo in base ai tag.
string[]
obbligatorio
Tag dei modelli che gli utenti possono selezionare, inclusi i tag dei fornitori come provider-anthropic o provider-openai. Passa [] per consentire solo i modelli con gli UID elencati.
Entrambi i campi sono obbligatori. I campi sconosciuti vengono rifiutati.

Esempio di richiesta

Risposta

In caso di esito positivo, la risposta è identica a quella di List Models, con il nuovo elenco di elementi consentiti applicato: tutti i modelli con il relativo flag allowed, i valori salvati di allowed_model_uids e allowed_model_tags e una nuova intestazione ETag.

Risposte di errore

Gli errori vengono restituiti nel formato {"error": "<message>"}.