Skip to main content
PUT
Atualizar a lista de permissões do Devin Desktop

Visão geral

Substitui a lista de permissões da sua equipe, a mesma configuração que os administradores gerenciam nos controles da organização no Devin Desktop. O corpo da requisição representa o estado completo desejado: as duas listas substituem as que estão armazenadas. Para evitar sobrescrever uma alteração que você ainda não viu, a requisição deve incluir no cabeçalho If-Match o ETag de uma resposta de List Models. Se a lista de permissões, os modelos disponíveis ou os preços deles tiverem mudado desde essa resposta, a atualização será rejeitada com 412 e você deverá listar os modelos novamente.
Este endpoint está em alfa (v2alpha). O formato da requisição e da resposta pode mudar.

Autenticação

Envie uma chave de API no cabeçalho Authorization:
Use uma chave de API de usuário de serviço do Devin (cog_...). Além da permissão Use Devin Desktop exigida pelo List Models, a função do usuário de serviço precisa ter a permissão Windsurf admin (account.windsurf.admin), que já vem incluída na função nativa Account Admin. Um usuário de serviço sem essa permissão consegue listar modelos, mas recebe 403 neste endpoint.

Requisição

string
obrigatório
O cabeçalho ETag de uma resposta de GET /api/v2alpha/models que reflete o estado atual. Obrigatório; * não é aceito.
string[]
obrigatório
UIDs dos modelos que os usuários podem escolher, p. ex. ["claude-sonnet-4-5"]. Passe [] para permitir modelos apenas por marcador.
string[]
obrigatório
Marcadores dos modelos que os usuários podem escolher, incluindo marcadores de provedor como provider-anthropic ou provider-openai. Passe [] para permitir apenas os UIDs de modelos listados.
Os dois campos são obrigatórios. Campos desconhecidos são rejeitados.

Exemplo de requisição

Resposta

Em caso de sucesso, a resposta é igual à de List Models, já com a nova lista de permissões aplicada: todos os modelos com a respectiva flag allowed, os valores armazenados de allowed_model_uids e allowed_model_tags e um novo cabeçalho ETag.

Respostas de erro

Os erros são retornados no formato {"error": "<message>"}.