---
title: "Pull request batch pending failure"
method: POST
path: "pull_request_batch.pending_failure"
---

# Pull request batch pending failure

`POST pull_request_batch.pending_failure` (webhook)

Triggered when the last pull request in a batch enters pending failure state

## Payload

- object — Triggered when the last pull request in a batch enters pending failure state
  - `test_branch` string, required — The branch the pull request or pull request batch was tested on
  - `test_branch_sha` string, required — The SHA of the branch the pull request or pull request batch was tested on
  - `test_pr_number` integer — The number of the pull request used to test the pull request or pull request batch
  - `failure_reason` 'START_TEST_RUN_INVALID_EVENT' | 'START_TEST_RUN_MERGE_CONFLICT' | 'START_TEST_RUN_CONFIG_NOT_FOUND' | 'START_TEST_RUN_CONFIG_PARSING_FAILURE' | 'START_TEST_RUN_CONFIG_MISSING_REQUIRED_STATUSES' | 'START_TEST_RUN_CONFIG_BAD_REQUIRED_STATUSES' | 'START_TEST_RUN_CONFIG_BAD_VERSION' | 'START_TEST_RUN_NO_REQUIRED_STATUSES' | 'TEST_RUN_REQUIRED_STATUS_FAILED' | 'TEST_RUN_TIMEOUT' | 'GITHUB_API_MERGE_PR_FAILED' | 'GITHUB_API_DIRECT_MERGE_PR_FAILED' | 'PR_UPDATED_AT_MERGE_TIME' | 'START_TEST_RUN_RETRY_EXHAUSTED' | 'START_TEST_RUN_DRAFT_PRS_NOT_ALLOWED' | 'TEST_RUN_FAILED_BY_OPTIMIZATION' — The reason the batch is pending failure
  - `type` 'pull_request_batch.pending_failure', required — The type of webhook event that occurred
  - `action` 'pending_failure', required — The type of action that triggered the webhook
  - `pr_numbers` integer[], required — The PR numbers of the pull requests in the batch
  - `pr_numbers_in_batch` integer[] — The PR numbers of all pull requests that were tested together in this batch. This may be a superset of pr_numbers if some PRs in the batch failed to merge.
  - `repository` object, required — The repository that the webhook event occurred in
    - `host` string, required — The type of source control for this repository
    - `owner` string, required — The name of the repository
    - `name` string, required — The user or organization that owns the repository
  - `status` 'pending_failure', required — The current status of the Pull Request batch
  - `target_branch` string, required — The name of the branch targeted by the merge queue where the event occurred
  - `timestamp` string, date-time, required — The ISO 8601 timestamp of when this state transition occurred

---

[API](https://skmtc.net/trunk/apis/trunk-apis.md) · [All operations](https://skmtc.net/trunk/apis/trunk-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trunk/trunk-apis/versions/f7b911d8e24c/schema)