{"meta":{"title":"APIs e webhooks de solicitações de pull empilhadas","intro":"Leia e gerencie solicitações de pull empilhadas programaticamente com as GitHub APIs REST e GraphQL e webhooks.","product":"Solicitações de pull","breadcrumbs":[{"href":"/pt/pull-requests","title":"Solicitações de pull"},{"href":"/pt/pull-requests/reference","title":"Demonstrativo"},{"href":"/pt/pull-requests/reference/stacked-pull-requests-apis-and-webhooks","title":"APIs e webhooks de PRs empilhadas"}],"documentType":"article"},"body":"# APIs e webhooks de solicitações de pull empilhadas\n\nLeia e gerencie solicitações de pull empilhadas programaticamente com as GitHub APIs REST e GraphQL e webhooks.\n\n> \\[!NOTE] Esse recurso está em versão prévia pública e está sujeito a alterações.\n\nAs GitHub APIs REST e GraphQL expõem solicitações de pull empilhadas. A API REST dá suporte à leitura e ao gerenciamento de pilhas, enquanto a API do GraphQL dá suporte a consultas somente leitura.\n\nUse a API para ler a associação de pilha de uma solicitação pull ou criar sua própria automação e integrações para solicitações de pull empilhadas.\n\n## API REST\n\nA API REST expõe solicitações de pull empilhadas de duas maneiras:\n\n* **O `stack` objeto em recursos de solicitação de pull.** Quando uma solicitação de pull pertence a uma pilha, seu recurso REST inclui um `stack` objeto. Isso permite que você leia a associação de pilha da solicitação de pull, incluindo o número e o tamanho da pilha e a posição e a base da solicitação de pull, diretamente da solicitação de pull.\n* **A API stacks.** Um conjunto dedicado de pontos de extremidade para listar, ler, criar, estender e dissolver pilhas. Essa é a superfície para criar e modificar pilhas.\n\nPara pontos de extremidade, parâmetros e esquemas, consulte [Endpoints da API REST para solicitações de pull](/pt/rest/pulls/pulls).\n\n> \\[!IMPORTANT]\n> Se você mesclar por meio da API e quiser usar solicitações de pull empilhadas, deverá usar a nova API de mesclagem assíncrona.\n\n### API de mesclagem\n\nAo mesclar uma solicitação de pull empilhada por meio da API, você deve usar o ponto de extremidade de mesclagem assíncrono.\n\nUma pilha não pode ser mesclada com os pontos de extremidade ou mutações síncronas herdados. Quando você mescla uma solicitação de pull empilhada, cada solicitação de pull na pilha até e incluindo a que você solicita é mesclada ou enfileirada para mesclar no branch base. A mesclagem de uma pilha de solicitações de pull pode envolver várias solicitações de pull que podem levar alguns minutos para serem mescladas. Por isso, a mesclagem é executada em segundo plano quando você envia uma solicitação de mesclagem e, em seguida, pode sondar o resultado.\n\nSomente o estado básico da solicitação de pull é verificado quando você envia uma PR aberta. As regras de proteção de branch e repositório são avaliadas posteriormente, quando a mesclagem realmente é executada e uma falha de regra é relatada como um resultado com falha durante a sondagem. Uma solicitação de mesclagem de pilha é atômica, o que significa que todo o grupo de solicitações de pull se mescla ou é adicionado à fila de mesclagem ou nenhum deles é.\n\nPara obter detalhes, consulte [Endpoints da API REST para solicitações de pull](/pt/rest/pulls/pulls?apiVersion=2026-03-10#merge-a-pull-request-asynchronously).\n\n## API GraphQL\n\nA API do GraphQL expõe a associação de pilha de uma solicitação de pull por meio de somente `stack` leitura e `stackEntry` campos no `PullRequest` tipo. Use esses campos para consultar a pilha à qual uma solicitação de pull pertence e sua posição dentro dela.\n\nA API do GraphQL é somente leitura para pilhas; não há mutações de pilha. Para criar ou modificar pilhas, use a API REST.\n\nPara campos, objetos e esquemas, consulte [Solicitações de pull](/pt/graphql/reference/pulls#object-pullrequeststack).\n\n## Webhooks\n\nQuando uma solicitação de pull pertence a uma pilha, GitHub adiciona uma `stack` propriedade ao `pull_request` objeto em cargas de eventos de webhook. Isso permite que aplicativos e integrações inspecionem o branch de destino da pilha, não apenas o branch pai direto da solicitação de pull.\n\nO `stack` objeto é incluído no conteúdo do `pull_request` webhook para eventos de ciclo de vida de solicitação de pull que ocorrem enquanto a solicitação de pull faz parte de uma pilha.\n\nConsulte [Eventos e cargas de webhook](/pt/webhooks/webhook-events-and-payloads?actionType=stacked#pull_request).\n\n## Leitura adicional\n\n* [Comandos da CLI de solicitações de pull empilhadas](/pt/pull-requests/reference/stacked-prs-cli-commands)\n* [Sobre solicitações de pull empilhadas](/pt/pull-requests/get-started/about-stacked-prs)"}