Pular para o conteúdo principal
Este guia ajuda você a migrar integrações existentes da API v1 ou v2 para as APIs atuais de organização e Enterprise. As APIs legadas (v1 e v2) continuarão funcionando durante o período de descontinuação, mas todos os novos recursos estarão disponíveis apenas na API atual.

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:
  1. Acesse Settings > API do Devin e abra a aba Usuários de Serviço
  2. Clique em Provision service user, atribua uma função adequada e escolha um prazo de expiração (30 dias por padrão)
  3. Copie a Chave de API exibida após o provisionamento (começa com cog_)
  4. 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ções
  • GET /v3/enterprise/audit-logs — Logs de auditoria
  • GET /v3/enterprise/consumption/* — Dados de uso e cobrança
  • GET /v3/enterprise/metrics/* — Métricas de uso
  • GET /v3/enterprise/members/users — Gerenciamento de usuários
  • GET /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:
Consulte Paginação para obter detalhes.

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údo application/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.
Recomendamos migrar para Usuários de Serviço o mais rápido possível para aproveitar o controle de acesso baseado em função, atribuição de sessão e novos recursos.

Precisa de ajuda?

Se você tiver problemas durante a migração, entre em contato pelo seu canal de suporte habitual do Devin ou fale conosco em support@cognition.ai.