> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notas de versão da API

> Acompanhe alterações, novos recursos e melhorias nas APIs do Devin

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](/pt-BR/release-notes/overview).

<div id="2026">
  ## 2026
</div>

<Update label="Junho de 2026">
  **Atualizações da API v3**

  * **Endpoint para adicionar IPs à lista de acesso por IP**: Adicionado `POST /v3/enterprise/ip-access-list` para acrescentar intervalos de IP à lista de acesso por IP do Enterprise sem substituir as entradas existentes. Diferentemente de `PUT /v3/enterprise/ip-access-list` (que substitui a lista inteira), este endpoint faz merge dos intervalos fornecidos com a lista atual. Requer a permissão `ManageEnterpriseSettings`.

  * **Endpoint para atualizar permissão git**: Adicionado `PATCH /v3/enterprise/organizations/{org_id}/git-providers/permissions/{git_permission_id}` para atualizar uma permissão git existente (por exemplo, alternar `read_only`). Requer a permissão `ManageGitIntegrations`.

  * **Endpoints de leitura de membros com escopo de organização (Beta)**: Adicionados `GET /v3beta1/organizations/{org_id}/members/users`, `GET /v3beta1/organizations/{org_id}/members/users/{user_id}` e `GET /v3beta1/organizations/{org_id}/members/idp-users` para listar e recuperar membros da organização usando um usuário de serviço com escopo de organização. Oferece suporte à paginação baseada em cursor (`after`, `first`) e à filtragem por `email`. Requer a permissão `ViewOrgMembership` no nível da organização.

  * **Modo Devin Lite para criação de sessão**: O parâmetro `devin_mode` em `POST /v3/organizations/{org_id}/sessions` agora também aceita `"lite"` (Devin Lite), além de `"normal"` e `"fast"`. Os modos Fast e Lite estão sujeitos à mesma feature flag e às mesmas restrições de preview do agent no Enterprise que o aplicativo web.
</Update>

<Update label="Maio de 2026">
  **Atualizações da API v3**

  * **Parâmetro de modo Devin para criação de sessão (21 de mai)**: Adicionado o parâmetro `devin_mode` a `POST /v3/organizations/{org_id}/sessions`. Aceita `"normal"` (modo Agent padrão) ou `"fast"` (modo Fast). Quando omitido, a sessão usa o modo padrão da organização. O modo Fast está sujeito à mesma feature flag e às mesmas restrições de preview do agent no Enterprise que o aplicativo web.

  * **Endpoint de repositórios de conexão Git (18 de mai)**: Adicionado `GET /v3/enterprise/git-providers/connections/{connection_id}/repositories` para listar os repositórios disponíveis em uma conexão Git específica do Enterprise. Oferece suporte à filtragem por `filter_name` e à paginação baseada em cursor (`after`, `first`). Requer a permissão `ManageGitIntegrations`.
</Update>

<Update label="Março de 2026">
  **Atualizações da API v3**

  * **Endpoint de geração de Insights de sessão (11 de mar)**: Adicionados os endpoints `POST /v3/organizations/{org_id}/sessions/{devin_id}/insights/generate` e `POST /v3/enterprise/sessions/{devin_id}/insights/generate` para acionar a geração sob demanda de Insights de sessão para a sessão. Retorna `{ "status": "started" }` quando a geração começa, ou `{ "status": "already_exists" }` se os insights já tiverem sido gerados ou estiverem em andamento. Faça polling do endpoint GET de insights existente para recuperar os resultados. Requer a permissão `ManageOrgSessions`.
</Update>

<Update label="Fevereiro de 2026">
  **Atualizações da API v3**

  * **Endpoints v3 promovidos para produção**: Os seguintes grupos de endpoints foram promovidos de `v3beta1` para `v3` (produção). Atualize suas URLs base de `/v3beta1/` para `/v3/` para esses endpoints:

    * Sessões (create, list, get, messages, archive, terminate, tags, insights) — escopos Enterprise e organização
    * Knowledge notes — escopos Enterprise e organização
    * Playbooks — escopos Enterprise e organização
    * Secrets — escopo de organização
    * Schedules — escopo de organização
    * Attachments — escopo de organização
    * Audit logs — escopos Enterprise e organização
    * Consumption & billing (cycles, daily breakdowns, limites de ACU) — escopo Enterprise
    * Metrics (DAU, WAU, MAU, PRs, sessões, buscas, usuários ativos, uso) — escopo Enterprise
    * Organizations, users, membros, roles, IDP groups — escopo Enterprise
    * Git connections & permissions — escopo Enterprise
    * Hypervisors, queue, IP access lists, org group limits — escopo Enterprise
    * Tags de sessão (tags padrão da organização) — escopo Enterprise

    **Ainda em beta** (`v3beta1`): Os endpoints de indexação de repositório, de provisionamento de usuários de serviço e de violações de guardrail permanecem em `v3beta1` e estão marcados com uma tag Beta na documentação.

  * **Endpoints de violações de guardrail**: Foram adicionados os endpoints `GET /v3beta1/enterprise/guardrail-violations` e `GET /v3beta1/enterprise/organizations/{org_id}/guardrail-violations` para consultar violações de guardrail em todo o Enterprise. Eles retornam detalhes da violação, incluindo o tipo de guardrail, justificativa, pontuação de confiança, ação tomada e a mensagem que disparou a violação. Suportam filtragem por `session_id` e `guardrail_id`, com intervalo de tempo e paginação baseada em cursor. Use o endpoint por organização para filtrar por organização. Requer a permissão `ManageEnterpriseSettings`.

  * **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`.
</Update>

<Update label="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.
</Update>

<div id="2025">
  ## 2025
</div>

<Update label="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)**: Adicionados novos parâmetros de requisição para workflows avançados de sessão: `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 Session tags (5 de dez)**: Adicionados endpoints de CRUD em `/v3/beta/enterprise/organizations/{org_id}/tags` para gerenciar as Session tags 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.
</Update>

<Update label="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.
</Update>

<Update label="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.
</Update>

<Update label="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.
</Update>

<Update label="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.
</Update>

<div id="2024">
  ## 2024
</div>

<Update label="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
</Update>

***

<div id="api-versioning-policy">
  ## Política de Versionamento da API
</div>

<div id="backward-compatibility">
  ### Compatibilidade com versões anteriores
</div>

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

<div id="deprecation-process">
  ### Processo de descontinuação
</div>

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

<div id="version-support">
  ### Suporte de versões
</div>

* **v1**: Versão legada — será descontinuada em breve em favor da Organization API (v3)
* **v2**: Versão legada — será descontinuada em breve em favor da Enterprise API (v3)
* **v3**: Disponível para uso geral, recomendada para todas as novas integrações

***

<div id="migrating-to-the-current-api">
  ## Migração para a API atual
</div>

Para obter instruções passo a passo de migração a partir da v1 ou v2, consulte o [guia de migração](/pt-BR/api-reference/getting-started/migration-guide).

<div id="support">
  ## Suporte
</div>

Em caso de dúvidas sobre alterações na API ou ajuda na migração, envie um e-mail para [support@cognition.ai](mailto:support@cognition.ai).