Pular para o conteúdo principal
Esta página registra as alterações específicas nas APIs do Devin (v1, v2 e v3). Para lançamentos de recursos do aplicativo, consulte as Notas de versão do aplicativo.

​
2025

​
Dezembro de 2025
Atualizações da API v3
  • Endpoint de arquivamento de sessão (11 de dez): Adicionado endpoint POST /v3beta1/organizations/{org_id}/sessions/{devin_id}/archive para arquivar sessões. Também foi adicionado o parâmetro de query archive a DELETE /v3beta1/organizations/{org_id}/sessions/{devin_id} (encerrar sessão) e o campo is_archived às respostas de sessão.
  • Remoção do parâmetro order (11 de dez): Mudança incompatível: Removido o parâmetro de query order do endpoint de listagem de sessões (GET /v3beta1/organizations/{org_id}/sessions). Os clientes devem deixar de enviar order; use paginação baseada em cursor com os parâmetros first/after em vez disso.
  • Suporte a sessões avançadas (8 de dez): Adicionado suporte a modos avançados de sessão (analyze, create, improve, batch, manage) com novos parâmetros de requisição: advanced_mode, child_playbook_id, session_links e bypass_approval. As respostas de sessão agora incluem os campos child_session_ids, parent_session_id e is_advanced.
  • Router de buscas (10 de dez): Adicionados endpoints de busca em nível de Enterprise e de organização em GET /v3beta1/enterprise/searches e GET /v3beta1/organizations/{org_id}/searches para listar buscas com paginação e filtragem.
  • Melhorias em audit logs (10 de dez): Adicionados o objeto data e os campos service_user_name e user_email às respostas de audit log. Adicionado o tipo de ação update_git_permission.
  • Router de tags de sessão (5 de dez): Adicionados endpoints de CRUD em /v3/beta/enterprise/organizations/{org_id}/tags para gerenciar as tags de sessão permitidas por organização. Quando a validação de tags estiver habilitada, a criação de sessões e as atualizações de tags passam a exigir que as tags estejam na lista permitida.
  • Endpoint de sessões Enterprise (5 de dez): Adicionado GET /v3/beta/enterprise/sessions para listar sessões em todo o Enterprise, com filtragem opcional por org_ids.
  • Atualizações de permissões de Git (5 de dez): Adicionado o campo prefix_path para corresponder repositórios por prefixo de caminho. Adicionados endpoints PUT e DELETE para substituir em lote ou limpar todas as permissões de uma organização.
  • Impersonação de sessão (5 de dez): Adicionado o parâmetro create_as_user_id ao endpoint de criação de sessão, permitindo que usuários de serviço criem sessões em nome de outros usuários.
  • Alteração na resposta de hypervisors (5 de dez): A resposta do endpoint de hypervisors agora retorna utilization_percentage em vez de max_slots e available_slots.
  • Routers de Notes e Playbooks (1º de dez): Adicionados endpoints de gerenciamento de Notes e Playbooks em nível de Enterprise e de organização à API v3. Endpoints de Notes exigem a permissão ManageAccountKnowledge; endpoints de Playbooks exigem a permissão ManageAccountPlaybooks.
Atualizações da API v2
  • Campo messages em sessões (11 de dez): Adicionado o campo messages à resposta da API de sessões v2, fornecendo todas as mensagens da sessão de forma semelhante à API v1.
  • Melhorias no schema de resposta (11 de dez): Adicionados esquemas de resposta adequados para endpoints de audit logs, snapshots e playbooks, incluindo AuditLogsResponse, EnterpriseSnapshotResponse e EnterprisePlaybookResponse.
Atualizações da API v1
  • Descontinuação de audit logs (5 de dez): O endpoint /v1/audit-logs foi descontinuado; use em vez disso os endpoints de audit logs das APIs v2 ou v3.
​
Novembro de 2025
Atualizações da API Enterprise v2
  • Atualização do limite de paginação (21 de nov): Limite máximo de paginação reduzido de 1000 para 200 itens por requisição, para melhor desempenho e confiabilidade. O limite padrão permanece 100. Essa alteração NÃO afeta a API Externa v1.
  • Router de sessões (16 de nov): Adicionados endpoints abrangentes de gerenciamento de sessões à API v2 para administradores Enterprise.
  • Endpoint da API de snapshots (3 de nov): Adicionado endpoint para recuperar detalhes de snapshots de forma programática.
Atualizações da API v1
  • Endpoint para encerrar sessão (31 de out): Adicionado endpoint para encerrar sessões em execução de forma programática.
​
Outubro de 2025
Lançamento da API v3 (Beta)
  • Lançamento da API v3 (23 de out): Lançada a API v3 com suporte completo a RBAC, modelo de autenticação de usuário de serviço e auditoria abrangente das ações de usuários de serviço.
Atualizações da API Enterprise v2
  • Endpoint de criação de snapshot (30 de out): Novo endpoint da Enterprise Organizations API v2 para administradores Enterprise clonarem repositórios de forma programática e criarem snapshots com etapas de configuração personalizadas e comandos de inicialização.
  • Melhorias na API de Playbooks (14 de out): Adicionada API para publicar playbooks Enterprise, com funcionalidade aprimorada para gerenciamento programático de playbooks.
​
Setembro de 2025
Atualizações da API Enterprise v2
  • Router de roles (25 de set): Adicionado router de roles Enterprise com cinco endpoints de API para gerenciar roles de forma programática.
Atualizações da API v1
  • API de Playbooks (6 de set): Adicionados endpoints abrangentes da API de Playbooks à v1 para criar, atualizar, listar e excluir playbooks de forma programática.
  • Endpoint de secrets (5 de set): Adicionado novo endpoint POST /v1/secrets para criar secrets via API.
​
Março de 2025
Lançamento da API Enterprise v2
  • Lançamento da API v2 (23 de mar): Lançada a Enterprise API v2 para administradores Enterprise, com recursos de gerenciamento de organizações, rastreamento de consumo e gerenciamento de membros.

​
2024

​
Outubro de 2024
Lançamento da API v1 (26 de outubro)
  • API REST para criação e gerenciamento programático de sessões
  • Endpoints de criação, monitoramento e gerenciamento de sessões
  • Suporte para upload e download de arquivos anexos
  • Autenticação básica com Chaves de API
  • Suporte à criação idempotente de sessões
  • Casos de uso: revisões automáticas de PRs, resolução de erros de lint, migrações

​
Política de Versionamento da API

​
Compatibilidade com versões anteriores

Nos esforçamos para manter a compatibilidade com versões anteriores dentro de versões principais. Alterações que quebram a compatibilidade serão:
  1. Anunciadas com pelo menos 7 dias de antecedência
  2. Documentadas nessas notas de versão
  3. Acompanhadas por guias de migração, quando aplicável

​
Processo de descontinuação

Quando descontinuamos um recurso da API:
  1. Anúncio: Anunciaremos a descontinuação e o respectivo cronograma
  2. Período de descontinuação: O recurso permanece disponível, mas marcado como descontinuado
  3. Remoção: O recurso é removido após o período de descontinuação

​
Suporte de Versões

  • v1: Disponível para uso geral, com manutenção ativa
  • v2: Disponível para uso geral, com manutenção ativa
  • v3: Beta - sujeito a alterações, ainda não recomendado para uso em produção

​
Guias de migração

​
Migração do v1 para o v3

Se você estiver criando novas integrações que exigem permissões granulares, considere usar o v3 em vez do v1: Principais diferenças:
  • Autenticação: o v3 requer tokens de usuário de serviço em vez de chaves de API pessoais/de serviço
  • Autorização: o v3 fornece controle de acesso baseado em função (RBAC) completo, com permissões baseadas em funções
  • Endpoints: o v3 usa padrões de URL diferentes (/v3beta1/* em vez de /v1/*)
Etapas de migração:
  1. Crie um usuário de serviço em Enterprise Settings > Service Users
  2. Atribua funções apropriadas ao usuário de serviço
  3. Gere uma chave de API para o usuário de serviço
  4. Atualize sua integração para usar os endpoints do v3
  5. Teste minuciosamente em um ambiente de não produção
Ver documentação da API v3 →

​
Migrando da v2 para a v3

A v3 oferece mais flexibilidade do que a v2 para automação em ambiente Enterprise: Principais diferenças:
  • Autenticação: a v3 usa usuários de serviço em vez de exigir chaves pessoais de Enterprise Admin
  • Autorização: a v3 oferece suporte a RBAC granular em vez de acesso apenas para Enterprise Admins
  • Escopo: a v3 pode ser limitada a organizações específicas, enquanto a v2 é sempre em nível Enterprise
Quando migrar:
  • Você precisa de automação com permissões sem privilégios de administrador
  • Você quer limitar o acesso à API a organizações específicas
  • Você precisa de uma separação clara entre contas humanas e contas de serviço
  • Você exige registros de auditoria detalhados para ações automatizadas

​
Suporte

Em caso de dúvidas sobre alterações na API ou necessidade de assistência na migração: