Skip to main content
PUT
Actualizar la lista de modelos permitidos de Devin Desktop

Descripción general

Reemplaza la lista de modelos permitidos de tu equipo, la misma configuración que los Admin gestionan en los controles de la organización de Devin Desktop. El cuerpo de la solicitud representa el estado deseado completo: las dos listas sobrescriben las que estén almacenadas. Para no sobrescribir un cambio que no hayas visto, la solicitud debe incluir en If-Match el ETag de una respuesta de List Models. Si la lista de permitidos, los modelos disponibles o sus precios han cambiado desde esa respuesta, la actualización se rechaza con un 412 y debes volver a listar los modelos.
Este endpoint está en fase alfa (v2alpha). La estructura de la solicitud y de la respuesta puede cambiar.

Autenticación

Envía una clave de API en el encabezado Authorization:
Usa una clave de API de usuario de servicio de Devin (cog_...). Además del permiso Use Devin Desktop que requiere List Models, el rol del usuario de servicio debe tener el permiso Windsurf admin (account.windsurf.admin), incluido en el rol integrado Account Admin. Un usuario de servicio sin este permiso puede listar modelos, pero recibe un 403 en este endpoint.

Solicitud

string
requerido
El encabezado ETag de una respuesta de GET /api/v2alpha/models que refleja el estado actual. Obligatorio; no se acepta *.
string[]
requerido
UID de los modelos que los usuarios pueden elegir, p. ej., ["claude-sonnet-4-5"]. Pasa [] para permitir modelos solo por etiqueta.
string[]
requerido
Etiquetas de los modelos que los usuarios pueden elegir, incluidas etiquetas de proveedor como provider-anthropic o provider-openai. Pasa [] para permitir solo los UID de modelos indicados.
Ambos campos son obligatorios. Se rechazan los campos desconocidos.

Ejemplo de solicitud

Respuesta

Si la operación se realiza correctamente, la respuesta es la misma que la de List Models, pero con la nueva lista de permitidos aplicada: cada modelo con su opción allowed, los valores almacenados de allowed_model_uids y allowed_model_tags, y un nuevo encabezado ETag.

Respuestas de error

Los errores se devuelven con el formato {"error": "<message>"}.