Atualização da API do GitHub Actions simplifica o acompanhamento de fluxos de trabalho para programadores

Peter Zhang 19 de fev. de 2026 23:29

A API de dispatch de fluxo de trabalho do GitHub agora retorna IDs de execução, eliminando a necessidade de soluções personalizadas de polling ao acionar fluxos de trabalho automatizados programaticamente.

O GitHub resolveu discretamente um dos pontos mais irritantes para programadores que automatizam os seus pipelines de CI/CD. O endpoint da API de dispatch de fluxo de trabalho agora retorna IDs de execução diretamente na sua resposta—uma pequena alteração que elimina horas de código alternativo.

Anteriormente, acionar um fluxo de trabalho via API não dava nada além de um estado 204 No Content. Sabia que o fluxo de trabalho tinha iniciado, mas boa sorte para descobrir qual execução era a sua sem fazer polling repetidamente à API ou construir sistemas de rastreamento personalizados. Isso está agora corrigido.

A atualização, anunciada a 19 de fevereiro de 2026, introduz um novo parâmetro opcional chamado return_run_details. Defina-o como verdadeiro e obterá uma resposta 200 OK contendo o ID do fluxo de trabalho, URL da API e URL do fluxo de trabalho. Ignore o parâmetro e o antigo comportamento 204 continua—compatibilidade retroativa preservada.

Os utilizadores do GitHub CLI a executar a versão 2.87.0 ou posterior obtêm isto automaticamente. Execute gh workflow run e verá o URL da execução criada mais o comando gh run view para o verificar. O CLI agora define return_run_details como verdadeiro por defeito.

Isto é importante para qualquer pessoa que construa automação sobre o GitHub Actions. Pense em sistemas de orquestração de implementação, pipelines de processamento em lote ou qualquer ferramenta que precise de rastrear o que gerou. A abordagem anterior—fazer polling ao endpoint de execuções e tentar corresponder carimbos de data/hora ou SHAs de commit—era frágil e ávida de limites de taxa.

O timing é notável. O GitHub apresentou o seu conceito de Agentic Workflows apenas dois dias antes, a 17 de fevereiro, sinalizando um investimento mais profundo no controlo programático de fluxos de trabalho. E a plataforma ainda está a recuperar reputacionalmente de uma grande interrupção que afetou runners hospedados a 2 de fevereiro, que perturbou pipelines de CI/CD em todo o ecossistema.

Para contexto, o GitHub aumentou as entradas máximas de workflow_dispatch de 10 para 25 em dezembro de 2025, outra melhoria de qualidade de vida para cenários de automação complexos.

A funcionalidade está agora ativa na API REST. A documentação está disponível no guia de eventos de fluxo de trabalho do GitHub Actions para quem estiver pronto para abandonar os seus hacks de rastreamento personalizados.

• github actions
• api
• devops
• automação
• ferramentas para programadores