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.

​
2026

​
Fevereiro de 2026
Atualizações da API v3
  • Endpoints de lista de acesso por IP (9 de fev): Adicionados os endpoints GET /v3beta1/enterprise/ip-access-list, PUT /v3beta1/enterprise/ip-access-list e DELETE /v3beta1/enterprise/ip-access-list para gerenciar listas de permissão de IP no nível Enterprise. O endpoint PUT substitui a lista inteira pelos intervalos de IP fornecidos (com suporte a notação CIDR). Requer a permissão ManageEnterpriseSettings.
  • Endpoints de sessões agendadas (3 de fev): Adicionados endpoints de gerenciamento de agendamentos no nível de organização: POST /v3beta1/organizations/{org_id}/schedules para criar agendamentos, GET /v3beta1/organizations/{org_id}/schedules para listar agendamentos, GET /v3beta1/organizations/{org_id}/schedules/{schedule_id} para obter um agendamento específico, PATCH /v3beta1/organizations/{org_id}/schedules/{schedule_id} para atualizar agendamentos e DELETE /v3beta1/organizations/{org_id}/schedules/{schedule_id} para excluir agendamentos. Requer a permissão ManageOrgSchedules.
​
Janeiro de 2026
Atualizações da API v3
  • Endpoints de limites de ACU (27 de jan): Adicionados endpoints de gerenciamento de limites de ACU em nível de Enterprise para sessões do Devin: GET /v3beta1/enterprise/consumption/acu-limits/devin para obter limites, PUT .../organizations/{org_id} para definir limites em nível de organização e DELETE para remover limites. Requer a permissão ManageBilling.
  • Endpoints de anexos (27 de jan.): Adicionados endpoints de anexos em nível de organização: POST /v3beta1/organizations/{org_id}/attachments para upload de anexos e GET /v3beta1/organizations/{org_id}/attachments/{uuid}/{name} para download de anexos. O upload requer a permissão UseDevinSessions, o download requer a permissão ViewOrgSessions.
  • Endpoint de fila (21 de jan): Adicionado o endpoint GET /v3beta1/enterprise/queue para que administradores Enterprise possam monitorar a integridade da fila de sessões. Retorna o número total de sessões na fila e um indicador de status (normal, elevated ou high). Útil para configurar alertas de problemas de capacidade. Requer a permissão ViewAccountMetrics.
  • Endpoints de sessões (19 de jan.): Adicionados os endpoints GET /v3beta1/enterprise/sessions/{devin_id} e GET /v3beta1/organizations/{org_id}/sessions/{devin_id} para obter detalhes de uma sessão específica. Adicionados também os endpoints POST /v3beta1/enterprise/sessions/{devin_id}/messages e POST /v3beta1/organizations/{org_id}/sessions/{devin_id}/messages para enviar mensagens a sessões ativas (sessões são retomadas automaticamente se estiverem suspensas). Também foi adicionado o parâmetro de filtro origins aos endpoints de listagem de sessões para filtrar pela origem da sessão (webapp, slack, teams, api, linear, jira, other).
  • Parâmetro de ordenação dos logs de auditoria (17 de jan.): Adicionado o parâmetro de consulta order (asc ou desc, padrão desc) aos endpoints de logs de auditoria de Enterprise e de organização para controlar a ordenação dos resultados.
  • Roteador de segredos (16 de jan.): Foram adicionados endpoints para gerenciamento de segredos em nível de organização: GET /v3beta1/organizations/{org_id}/secrets para listar segredos, POST /v3beta1/organizations/{org_id}/secrets para criar segredos e DELETE /v3beta1/organizations/{org_id}/secrets/{secret_id} para excluir segredos. É necessária a permissão ManageOrgSecrets.
  • Correção nos logs de auditoria (15 de jan.): Foi corrigido um problema em que end_cursor não era retornado nas respostas da API de logs de auditoria quando havia itens na página.
  • Provisionamento de usuários de serviço (14 de jan.): Adicionados os endpoints POST /v3beta1/enterprise/service-users e POST /v3beta1/organizations/{org_id}/service-users para provisionamento programático de novos usuários de serviço. Garante a prevenção contra escalonamento de privilégios: as permissões da função de destino devem ser um subconjunto das permissões do chamador, e permissões ManageServiceUsers nunca podem ser concedidas. Requer permissão ManageAccountServiceUsers ou ManageOrgServiceUsers, respectivamente.
  • Endpoints em nível de Enterprise para grupos de IDP (14 de jan.): Adicionamos GET /v3beta1/enterprise/idp-groups para listar grupos de IDP registrados em uma Enterprise, POST /v3beta1/enterprise/idp-groups para registrar em lote grupos de IDP (até 100 por vez) e DELETE /v3beta1/enterprise/idp-groups/{idp_group_name} para remover um grupo de IDP registrado. Grupos com atribuições de função existentes ou associações de usuários não podem ser excluídos. Requer a permissão ManageAccountMembership.
  • Ações do log de auditoria (12 de jan.): Foram adicionados os tipos de ação create_join_request, automatic_join_event e reject_join_request às respostas do log de auditoria.
  • Endpoint de usuários ativos (8 de jan.): Foi adicionado o endpoint GET /v3beta1/enterprise/metrics/active-users para obter usuários ativos únicos em um intervalo de datas personalizado. Diferentemente dos endpoints de DAU/WAU/MAU, que retornam listas segmentadas por período, esse endpoint retorna uma única contagem de usuários ativos únicos em todo o intervalo especificado. Suporta filtragem por IDs de organização e limiares de atividade configuráveis (min_sessions, min_searches).
  • Status padrão dos hipervisores (8 de jan.): O endpoint GET /v3beta1/enterprise/hypervisors agora, por padrão, filtra pelo status available em vez de retornar todos os hipervisores. Passe status=all para obter hipervisores independentemente do status.
  • Segredos de sessão (5 de janeiro): Adicionado o parâmetro session_secrets ao endpoint de criação de sessão (POST /v3beta1/organizations/{org_id}/sessions). Segredos de sessão são segredos temporários disponíveis apenas na sessão atual e não são armazenados nos segredos da organização.
  • Correção de paginação (5 de jan.): Corrigimos um bug de paginação na API Enterprise Users v3 em que end_cursor nem sempre era retornado corretamente.
Atualizações da API v2
  • Correção de clonagem de repositório (20 de jan): Corrigido o esquema do endpoint POST /v2/enterprise/organizations/{org_id}/clone-repository. Removido o formato legado RepoSetupStepsT e simplificado o corpo da requisição para usar campos simples (pull_repo_commands, run_lint_commands, run_project_commands, update_dependencies_commands, repo_note, repo_path).
  • Campos de URL de permissões do Git (15 de jan.): Adicionamos os campos group_prefix_url e repo_url ao esquema GitPermissionRequest, fornecendo alternativas de URLs completas para correspondência, baseada em caminho, de repositórios e prefixos de grupo.
  • Campo de função de membro da organização (8 de jan): Foi adicionado o campo org_role_name à resposta de GET /v2/enterprise/organizations/{org_id}/members, que indica a função de cada membro dentro da organização.
  • Opção de criação de organização (8 de jan.): Adicionamos o parâmetro booleano add_creator_as_member (padrão true) ao endpoint POST /v2/enterprise/organizations, permitindo que administradores Enterprise criem organizações sem serem adicionados automaticamente como membros.
  • Documentação sobre fuso horário de consumo (7 de jan): Adicionamos documentação sobre o comportamento de fuso horário nos endpoints de consumo diário. Os ciclos de faturamento usam a meia-noite no fuso horário PST (08:00:00 UTC) como limite do dia.
Atualizações da API v1
  • Atualização de tipos de segredo (16 jan): Adicionado dictionary como um valor reconhecido para o tipo de segredo no esquema da API de segredos. Observação: a criação de segredos com tipo dictionary foi descontinuada; use cookie, key-value ou totp em vez disso.

​
2025

​
Dezembro de 2025
Atualizações da API v3
  • Endpoint de limites de grupos de organizações (23 de dez): Adicionados endpoints GET /v3beta1/enterprise/org-group-limits e PUT /v3beta1/enterprise/org-group-limits para gerenciar configurações de grupos de organizações. Os grupos associam conjuntos de IDs de organização a limites máximos opcionais de Agent Compute Unit por ciclo de cobrança. Requer a permissão ManageOrganizations. Esse recurso requer habilitação pela sua equipe de conta.
  • 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.
  • 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.
  • 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 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
  • Endpoint de limites de grupos de organizações (23 de dez): Adicionados endpoints GET /v2/enterprise/org-group-limits e PUT /v2/enterprise/org-group-limits para gerenciar configurações de grupos de organizações. Os grupos associam conjuntos de IDs de organização a limites máximos opcionais de Agent Compute Unit por ciclo de cobrança. O endpoint PUT substitui toda a configuração (grupos que não estiverem incluídos na requisição serão excluídos). Esse recurso requer habilitação pela sua equipe de conta.
  • Endpoint self (23 de dez): Adicionado endpoint GET /v2/enterprise/self que retorna informações sobre a Chave de API autenticada, incluindo o ID da chave, o ID do usuário associado, o e-mail do usuário e o ID da organização.
  • 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 em nível de 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, acompanhamento 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 ajuda na migração: