O que está mudando
Etapa 1: Criar um Usuário de Serviço
Substitua sua Chave de API legada por um Usuário de Serviço:- Acesse Settings > API do Devin e abra a aba Usuários de Serviço
- Clique em Provision service user, atribua uma função adequada e escolha um prazo de expiração (30 dias por padrão)
- Copie a Chave de API exibida após o provisionamento (começa com
cog_) - Atualize sua integração para usar a nova chave
Suas Chaves de API legadas continuarão funcionando durante o período de descontinuação. Você pode migrar gradualmente.
Etapa 2: Atualizar URLs dos endpoints
Endpoints de sessão
Endpoints do Knowledge
Endpoints de playbooks
Os endpoints
/playbooks estão obsoletos em todas as versões da API. Os Playbooks estão migrando para Habilidades. Crie novas instruções como habilidades na página Customize. Contas criadas a partir de 24 de outubro de 2026 que não tenham playbooks recebem 410 desses endpoints. Consulte Os Playbooks estão migrando para Habilidades.Endpoints de segredos
Endpoints exclusivos do Enterprise (novos)
Esses endpoints não têm equivalente nas versões v1/v2 — eles estão disponíveis apenas na API atual:GET /v3/enterprise/organizations— Listar organizaçõesGET /v3/enterprise/audit-logs— Logs de auditoriaGET /v3/enterprise/consumption/*— Dados de uso e cobrançaGET /v3/enterprise/metrics/*— Métricas de usoGET /v3/enterprise/members/users— Gerenciamento de usuáriosGET /v3/enterprise/roles— Gerenciamento de funções- Provisionamento de usuários de serviço, listas de acesso por IP, limites de ACU e mais
Etapa 3: Atualizar a paginação
A API atual usa paginação baseada em cursor, em vez de baseada em deslocamento:Etapa 4: Lidar com alterações no formato de resposta
Valores de status da sessão
A API atual retorna informações de status mais detalhadas. Consulte a referência do endpoint para ver o esquema completo.Respostas de erro
A API atual retorna erros no formato RFC 9457, com o tipo de conteúdoapplication/problem+json. O corpo contém os membros type, title e status e pode incluir também os membros detail, instance, errors e error_code.
As APIs legadas retornam um corpo JSON com um membro detail. Nas respostas 422 da API atual, detail é uma string, e o membro errors contém os erros de cada campo.
Cronograma de descontinuação
Settings > API do Devin lista as chaves legadas na aba Chaves de API (legacy). Enterprise settings > API do Devin lista essas chaves na aba API legada, que exibe um banner de descontinuação. Durante o período de transição:- Agora: As Chaves de API legadas continuam funcionando. Novas organizações podem não ter acesso à criação de chaves legadas.
- Período de descontinuação: Tanto as chaves legadas quanto os tokens de Usuário de Serviço funcionam em paralelo.
- Fim do ciclo de vida: As Chaves de API legadas serão removidas em breve. Acompanhe suas configurações do Devin para novos comunicados.

