---
title: "Get the activity log"
method: GET
path: "/repos/{owner}/{repository}/logs"
tags: ["activity_log"]
---

# Get the activity log

`GET /repos/{owner}/{repository}/logs`

Get the activity log of the requested repository. Supports filtering by `event_type`, derived `outcome` (`success` / `failure` / `pending` / `neutral`), `trigger` (include only these trigger strings — Datadog `Only`), and `not_trigger` (exclude). `trigger` and `not_trigger` are mutually exclusive.

## Path parameters

- `owner` string, required — The owner of the repository
- `repository` string, required — The name of the repository

## Query parameters

- `pull_request` integer[], nullable — Filter events by pull-request number. Repeatable to match several PRs at once (e.g. `?pull_request=1&pull_request=2`).
- `base_ref` string, nullable — Get events for PRs to the given base ref
- `batch_pull` integer[], nullable — Filter to batch (draft) pull requests' own lifecycle events by number (surfaced in the dashboard as "Batch Pull Request"). Repeatable to match several batches at once. The draft PR is the Mergify-opened pull request that speculatively checks a batch; this returns each batch's `action.queue.checks_start` / `action.queue.checks_end` events (which snapshot the draft PR number) plus the batch's bisection events. When `in_place` is true the number is the user's own PR rather than a Mergify draft. The number rotates on checks-retry — each event snapshots the number at that attempt. Mutually exclusive with `not_batch_pull` (exclusion).
- `not_batch_pull` integer[], nullable — Exclude batch (draft) pull requests' own lifecycle events by number — the same event set `batch_pull` includes, negated. Repeatable. Mirrors Datadog's facet semantics: unchecking a batch pull request in the dashboard sidebar adds it to the exclusion list. Mutually exclusive with `batch_pull` (positive include).
- `event_type` EventType[], nullable — The specific types of events to select
- `not_event_type` EventType[], nullable — Exclude events whose type matches any of the given values. Mutually exclusive with `event_type` (positive include).
- `outcome` EventOutcome[], nullable — Filter events by derived outcome label (`success` / `failure` / `pending` / `neutral`). Repeatable to match several outcomes at once (e.g. `?outcome=success&outcome=failure`).
- `not_outcome` EventOutcome[], nullable — Exclude events whose derived outcome label matches any of the given values (`success` / `failure` / `pending` / `neutral`). Repeatable. Mirrors Datadog's facet semantics: unchecking an outcome in the dashboard sidebar adds it to the exclusion list. Mutually exclusive with `outcome` (positive include).
- `trigger` string[], nullable — Include only events whose `trigger` matches one of the given values (exact match). Repeatable. Mirrors Datadog's facet behaviour after clicking `Only`: the URL switches from exclusion mode to inclusion mode with a positive list — shorter than `not_trigger=<everything else>`. Mutually exclusive with `not_trigger`.
- `not_trigger` string[], nullable — Exclude events whose `trigger` matches any of the given values (exact match). Repeatable. Mirrors Datadog's facet semantics: the default state is `all triggers included`, and unchecking a trigger in the dashboard sidebar adds it to the exclusion list. Mutually exclusive with `trigger` (positive include).
- `not_pull_request` integer[], nullable — Exclude events whose pull request matches any of the given numbers. Mutually exclusive with `pull_request` (positive include).
- `received_from` string, date-time, nullable — Start of the time range (ISO 8601 with timezone, e.g. 2024-01-01T00:00:00Z). Defaults to `received_to - 1 day`.
- `received_to` string, date-time, nullable — End of the time range (ISO 8601 with timezone, e.g. 2024-01-01T00:00:00Z). Defaults to `now`.
- `cursor` string, nullable — The opaque cursor of the current page. Must be extracted from RFC 5988 pagination links to get first/previous/next/last pages
- `per_page` integer — The number of items per page

## Response `200`

Successful Response

- EventsResponse
  - `size` integer, required — The number of items in this page
  - `per_page` integer, required — The number of items per page
  - `events` union[], required
    - union
      - EventAssign
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.assign', required
        - `metadata` EventAssignMetadata, required
          - `added` string[], required
          - `removed` string[], required
      - EventBackport
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.backport', required
        - `metadata` EventCopyMetadata, required
          - `to` string, required
          - `pull_request_number` integer, required
          - `conflicts` boolean, required
      - EventClose
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.close', required
        - `metadata` EventCloseMetadata, required
          - `message` string, required
      - EventComment
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.comment', required
        - `metadata` EventCommentMetadata, required
          - `message` string, required
      - EventCopy
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.copy', required
        - `metadata` EventCopyMetadata, required
          - `to` string, required
          - `pull_request_number` integer, required
          - `conflicts` boolean, required
      - EventDeleteHeadBranch
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.delete_head_branch', required
        - `metadata` EventDeleteHeadBranchMetadata, required
          - `branch` string, required
      - EventDismissReviews
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.dismiss_reviews', required
        - `metadata` EventDismissReviewsMetadata, required
          - `users` string[], required
      - EventEdit
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.edit', required
        - `metadata` EventEditMetadata, required
          - `draft` boolean, required
      - EventLabel
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.label', required
        - `metadata` EventLabelMetadata, required
          - `added` string[], required
          - `removed` string[], required
      - EventMerge
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.merge', required
        - `metadata` EventMergeMetadata, required
          - `branch` string, required
      - EventPostCheck
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.post_check', required
        - `metadata` EventPostCheckMetadata, required
          - `conclusion` 'success' | 'failure' | 'neutral' | 'cancelled' | 'skipped' | 'timed_out' | 'action_required' | 'stale' | 'startup_failure', nullable, required
          - `title` string, required
          - `summary` string, required
      - EventGithubActions
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.github_actions', required
        - `metadata` EventGithubActionsMetadata, required
          - `workflow` string, required
          - `inputs` object, required
      - EventQueueEnter
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.queue.enter', required
        - `metadata` EventQueueEnterMetadata, required
          - `queue_name` string, required
          - `branch` string, required
          - `queued_at` string, date-time, required
          - `priority_rule_name` string, nullable, required
          - `session_id` string, uuid, required
      - EventQueueLeave
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.queue.leave', required
        - `metadata` EventQueueLeaveMetadata, required
          - `reason` string, required
          - `merged` boolean, required
          - `queue_name` string, required
          - `branch` string, required
          - `queued_at` string, date-time, required
          - `seconds_waiting_for_schedule` integer, required
          - `seconds_waiting_for_freeze` integer, required
          - `priority_rule_name` string, nullable, required
          - `conditions_evaluation` MergifyEngineRulesConditionsQueueConditionEvaluationResultSerialized, required
            - `match` boolean, required
            - `label` string, required
            - `is_label_user_input` boolean, required
            - `description` string, nullable, required
            - `attribute_name` string, nullable, required
            - `operator` string, nullable, required
            - `schedule` object, nullable, required
            - `subconditions` MergifyEngineRulesConditionsQueueConditionEvaluationResultSerialized[], required
            - `evaluations` MergifyEngineRulesConditionsQueueConditionEvaluationResultEvaluationSerialized[], required
              - …
          - `checks` MergifyEngineQueueMergeQueueChecksQueueCheckSerialized[], required
            - `name` string, required
            - `description` string, required
            - `url` string, nullable, required
            - `details_url` string, nullable
            - `state` 'failure' | 'error' | 'cancelled' | 'action_required' | 'timed_out' | 'pending' | 'neutral' | 'skipped' | 'stale' | 'success', required
            - `avatar_url` string, nullable, required
          - `unsuccessful_checks` MergifyEngineQueueMergeQueueChecksQueueCheckSerialized[], required
            - `name` string, required
            - `description` string, required
            - `url` string, nullable, required
            - `details_url` string, nullable
            - `state` 'failure' | 'error' | 'cancelled' | 'action_required' | 'timed_out' | 'pending' | 'neutral' | 'skipped' | 'stale' | 'success', required
            - `avatar_url` string, nullable, required
          - `pull_request_head_sha` string, required
          - `session_id` string, uuid, nullable, required
          - `dequeue_code` union, required
            - 'PR_MERGED' | 'PR_MERGED_INTERMEDIATE_RESULTS_SKIPPED'
            - 'PR_DEQUEUED' | 'PR_DEQUEUED_FROM_PARTITION' | 'PR_AHEAD_DEQUEUED' | 'BATCH_AHEAD_FAILED' | 'PR_WITH_HIGHER_PRIORITY_QUEUED' | 'SCHEDULED_FREEZE_STATUS_CHANGED' | 'SPECULATIVE_CHECK_NUMBER_REDUCED' | 'CHECKS_TIMEOUT' | 'CHECKS_FAILED' | 'DROPPED_BY_BISECTION_ELIMINATION' | 'QUEUE_RULE_MISSING' | 'BASE_BRANCH_MISSING' | 'BASE_BRANCH_CHANGED' | 'PR_UNEXPECTEDLY_FAILED_TO_MERGE' | 'BATCH_MAX_FAILURE_RESOLUTION_ATTEMPTS' | 'PR_CHECKS_STOPPED_BECAUSE_MERGE_QUEUE_PAUSE' | 'CONFLICT_WITH_BASE_BRANCH' | 'CONFLICT_WITH_PULL_AHEAD' | 'BRANCH_UPDATE_FAILED' | 'DRAFT_PULL_REQUEST_CHANGED' | 'BATCH_PULL_REQUEST_CLOSED' | 'PULL_REQUEST_UPDATED' | 'MERGE_QUEUE_RESET' | 'INCOMPATIBILITY_WITH_BRANCH_PROTECTIONS' | 'PR_MANUALLY_MERGED' | 'DRAFT_PULL_REQUEST_CREATION_FAILED' | 'DRAFT_PULL_REQUEST_CREATION_BRANCH_NOT_INDEXED' | 'CONFIGURATION_CHANGED' | 'UNPROCESSABLE_PULL_REQUEST' | 'PR_MANUALLY_DEQUEUED' | 'STACK_PREDECESSOR_DEQUEUED' | 'INTERMEDIATE_RESULTS_SKIPPED' | 'CHECKS_RETRIED' | 'SCHEDULE_BLOCKED_AHEAD_YIELDED' | 'BASE_REF_ALIGNMENT_TIMEOUT' | 'GITHUB_STACKED_PULL_REQUEST_MERGE_UNSUPPORTED' | 'BATCH_SCOPES_CHANGED' | 'BATCH_AHEAD_BRANCH_EDITED' | 'CHECKS_INTERRUPTED'
          - `batch_id` string, uuid, nullable, required — The batch the pull request was in when it left the queue. Use it to correlate this leave with the batch's checks_start / checks_end events. Null when the pull request left before being embarked in a batch, or on events persisted before this field was added.
          - `scopes` string[], nullable, required — The scopes of the batch the pull request was in when it left. Empty when the queue is not scoped. Null when the pull request left before being embarked in a batch, or on events persisted before this field was added.
          - `all_scopes` boolean, nullable, required — Whether the train car the pull request was in impacted every scope (a merge-queue barrier). Null when the pull request left before being embarked in a car, or on events persisted before this field was added.
      - EventQueueChecksStart
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.queue.checks_start', required
        - `metadata` EventQueueChecksStartMetadata, required
          - `branch` string, required
          - `priority_rule_name` string, nullable, required
          - `queue_name` string, required
          - `queued_at` string, date-time, required
          - `start_reason` string, required
          - `speculative_check_pull_request` MergifyEngineSignalsSpeculativeCheckPullRequest, required
            - `number` integer, required
            - `in_place` boolean, required
            - `checks_timed_out` boolean, required
            - `checks_conclusion` 'success' | 'failure' | 'neutral' | 'cancelled' | 'skipped' | 'stale' | 'action_required' | 'timed_out' | 'error' | 'pending', required
            - `checks_started_at` string, date-time, nullable, required
            - `checks_ended_at` string, date-time, nullable, required
            - `unsuccessful_checks` MergifyEngineQueueMergeQueueChecksQueueCheckSerialized[], required
              - …
            - `pull_request_numbers` integer[], required
          - `batch_id` string, uuid, nullable, required — The batch this event concerns. Correlate the queue events for a batch (checks_start / checks_end / leave / bisection) on this id. Null on events persisted before this field was added.
          - `train_car_id` string, uuid, nullable, required — Deprecated: use `batch_id` instead (same value).
          - `batch_name` string, nullable, required — The display name of the batch this event concerns, the same name the merge queue shows while the batch is queued. Recorded on the event because the name lives only in the live queue state and is unrecoverable once the batch leaves the queue. Null on events persisted before this field was added.
          - `scopes` string[], nullable, required — The scopes of the batch checking this pull request. Batches with disjoint scopes run their checks concurrently, so the scope tells which parallel lane the batch occupies. Empty when the queue is not scoped. Null on events persisted before this field was added.
          - `parent_batch_ids` string[], nullable, required — The batch ids this batch descends from. A batch inherits its parents' check results, so this links a batch back to the ones checked before it. Empty on a first check with no predecessor. Null on events persisted before this field was added.
          - `previous_batch_id` string, uuid, nullable, required — The ID of the batch checked just before this one for the same pull request, when this check is a restart. Null on the first check.
          - `previous_batch_name` string, nullable, required — The display name of `previous_batch_id`'s batch, read back from that batch's own checks_end event. Null on the first check, and when the predecessor was checked before `batch_name` was recorded on events.
          - `session_id` string, uuid, required
          - `all_scopes` boolean, nullable — Whether the train car checking this pull request impacts every scope (a merge-queue barrier). Null on events persisted before this field existed.
      - EventQueueChecksEnd
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.queue.checks_end', required
        - `metadata` EventQueueChecksEndMetadata, required
          - `aborted` boolean, required
          - `abort_code` 'PR_DEQUEUED' | 'PR_DEQUEUED_FROM_PARTITION' | 'PR_AHEAD_DEQUEUED' | 'BATCH_AHEAD_FAILED' | 'PR_WITH_HIGHER_PRIORITY_QUEUED' | 'SCHEDULED_FREEZE_STATUS_CHANGED' | 'SPECULATIVE_CHECK_NUMBER_REDUCED' | 'CHECKS_TIMEOUT' | 'CHECKS_FAILED' | 'DROPPED_BY_BISECTION_ELIMINATION' | 'QUEUE_RULE_MISSING' | 'BASE_BRANCH_MISSING' | 'BASE_BRANCH_CHANGED' | 'PR_UNEXPECTEDLY_FAILED_TO_MERGE' | 'BATCH_MAX_FAILURE_RESOLUTION_ATTEMPTS' | 'PR_CHECKS_STOPPED_BECAUSE_MERGE_QUEUE_PAUSE' | 'CONFLICT_WITH_BASE_BRANCH' | 'CONFLICT_WITH_PULL_AHEAD' | 'BRANCH_UPDATE_FAILED' | 'DRAFT_PULL_REQUEST_CHANGED' | 'BATCH_PULL_REQUEST_CLOSED' | 'PULL_REQUEST_UPDATED' | 'MERGE_QUEUE_RESET' | 'INCOMPATIBILITY_WITH_BRANCH_PROTECTIONS' | 'PR_MANUALLY_MERGED' | 'DRAFT_PULL_REQUEST_CREATION_FAILED' | 'DRAFT_PULL_REQUEST_CREATION_BRANCH_NOT_INDEXED' | 'CONFIGURATION_CHANGED' | 'UNPROCESSABLE_PULL_REQUEST' | 'PR_MANUALLY_DEQUEUED' | 'STACK_PREDECESSOR_DEQUEUED' | 'INTERMEDIATE_RESULTS_SKIPPED' | 'CHECKS_RETRIED' | 'SCHEDULE_BLOCKED_AHEAD_YIELDED' | 'BASE_REF_ALIGNMENT_TIMEOUT' | 'GITHUB_STACKED_PULL_REQUEST_MERGE_UNSUPPORTED' | 'BATCH_SCOPES_CHANGED' | 'BATCH_AHEAD_BRANCH_EDITED' | 'CHECKS_INTERRUPTED', nullable, required
          - `abort_reason` string, nullable, required
          - `abort_status` 'DEFINITIVE' | 'REEMBARKED', required
          - `branch` string, required
          - `priority_rule_name` string, nullable, required
          - `queue_name` string, required
          - `queued_at` string, date-time, required
          - `retry_attempt` integer, nullable, required
          - `max_retries` integer, nullable, required
          - `speculative_check_pull_request` MergifyEngineSignalsSpeculativeCheckPullRequest, required
            - `number` integer, required
            - `in_place` boolean, required
            - `checks_timed_out` boolean, required
            - `checks_conclusion` 'success' | 'failure' | 'neutral' | 'cancelled' | 'skipped' | 'stale' | 'action_required' | 'timed_out' | 'error' | 'pending', required
            - `checks_started_at` string, date-time, nullable, required
            - `checks_ended_at` string, date-time, nullable, required
            - `unsuccessful_checks` MergifyEngineQueueMergeQueueChecksQueueCheckSerialized[], required
              - …
            - `pull_request_numbers` integer[], required
          - `batch_id` string, uuid, nullable, required — The batch this event concerns. Correlate the queue events for a batch (checks_start / checks_end / leave / bisection) on this id. Null on events persisted before this field was added.
          - `train_car_id` string, uuid, nullable, required — Deprecated: use `batch_id` instead (same value).
          - `batch_name` string, nullable, required — The display name of the batch this event concerns, the same name the merge queue shows while the batch is queued. Recorded on the event because the name lives only in the live queue state and is unrecoverable once the batch leaves the queue. Null on events persisted before this field was added.
          - `scopes` string[], nullable, required — The scopes of the batch checking this pull request. Batches with disjoint scopes run their checks concurrently, so the scope tells which parallel lane the batch occupies. Empty when the queue is not scoped. Null on events persisted before this field was added.
          - `parent_batch_ids` string[], nullable, required — The batch ids this batch descends from. A batch inherits its parents' check results, so this links a batch back to the ones checked before it. Empty on a first check with no predecessor. Null on events persisted before this field was added.
          - `session_id` string, uuid, required
          - `all_scopes` boolean, nullable — Whether the train car checking this pull request impacts every scope (a merge-queue barrier). Null on events persisted before this field existed.
      - EventQueueChecksNotStarted
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.queue.checks_not_started', required
        - `metadata` EventQueueChecksNotStartedMetadata, required
          - `branch` string, required
          - `priority_rule_name` string, nullable, required
          - `queue_name` string, required
          - `queued_at` string, date-time, required
          - `reason` string, required
          - `session_id` string, uuid, required
        - `attempt` integer, nullable — 1-based number of this draft-creation failure within the pull request's current queue stay (`metadata.session_id`): 1 on the first failure, incrementing on each automatic retry. Authoritative — it reflects every stored failure of the stay, independent of the requested time window or page, so a repeatedly-stuck pull request reads its true count. Null/absent on events that predate this field or when the count could not be derived.
      - EventQueueConflictDeferred
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.queue.conflict_deferred', required
        - `metadata` EventQueueConflictDeferredMetadata, required
          - `branch` string, required
          - `priority_rule_name` string, nullable, required
          - `queue_name` string, required
          - `queued_at` string, date-time, required
          - `reason` string, required
          - `session_id` string, uuid, required
          - `blocking_pull_request_numbers` integer[], required — The pull requests ahead in the queue that were in flight when the merge failed. The conflicting hunk belongs to at least one of them; the queue never learns which, so `reason` claims a conflict with the set rather than with a named pull request.
      - EventQueueBatchBisectionStart
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.queue.batch_bisection_start', required
        - `metadata` EventQueueBatchBisectionStartMetadata, required
          - `queue_name` string, required
          - `priority_rule_name` string, nullable, required
          - `original_batch_pr_numbers` integer[], required
          - `batch_size_before_split` integer, required
          - `number_of_sub_batches` integer, required
          - `bisection_depth` integer, required
          - `is_top_level` boolean, required
          - `session_id` string, uuid, required
          - `batch_id` string, uuid, nullable, required — The batch this event concerns. Correlate the queue events for a batch (checks_start / checks_end / leave / bisection) on this id. Null on events persisted before this field was added.
          - `train_car_id` string, uuid, nullable, required — Deprecated: use `batch_id` instead (same value).
          - `batch_name` string, nullable, required — The display name of the batch this event concerns, the same name the merge queue shows while the batch is queued. Recorded on the event because the name lives only in the live queue state and is unrecoverable once the batch leaves the queue. Null on events persisted before this field was added.
      - EventQueueBatchBisectionEnd
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.queue.batch_bisection_end', required
        - `metadata` EventQueueBatchBisectionEndMetadata, required
          - `queue_name` string, required
          - `priority_rule_name` string, nullable, required
          - `original_batch_pr_numbers` integer[], required
          - `culprit_found` boolean, required
          - `culprit_pr_numbers` integer[], required
          - `confirmed_culprit_pr_numbers` integer[], nullable, required
          - `dropped_unverified_pr_numbers` integer[], nullable, required
          - `remaining_pr_numbers` integer[], required
          - `max_failure_resolution_reached` boolean, required
          - `session_id` string, uuid, required
          - `batch_id` string, uuid, nullable, required — The batch this event concerns. Correlate the queue events for a batch (checks_start / checks_end / leave / bisection) on this id. Null on events persisted before this field was added.
          - `train_car_id` string, uuid, nullable, required — Deprecated: use `batch_id` instead (same value).
          - `batch_name` string, nullable, required — The display name of the batch this event concerns, the same name the merge queue shows while the batch is queued. Recorded on the event because the name lives only in the live queue state and is unrecoverable once the batch leaves the queue. Null on events persisted before this field was added.
      - EventQueueMerged
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.queue.merged', required
        - `metadata` EventQueueMergedMetadata, required
          - `branch` string, required
          - `queue_name` string, required
          - `queued_at` string, date-time, required
          - `priority_rule_name` string, nullable, required
          - `session_id` string, uuid, required
          - `merge_commit_sha` string, nullable, required — The commit this queue merge landed on the base branch (its new tip): a merge/squash commit, or the fast-forwarded head SHA for fast-forward merges. Null on events persisted before this field was added.
      - EventRebase
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `metadata` EventNoMetadata, required
        - `type` 'action.rebase', required
      - EventRefresh
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `metadata` EventNoMetadata, required
        - `type` 'action.refresh', required
      - EventRequestReviews
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.request_reviews', required
        - `metadata` EventRequestReviewsMetadata, required
          - `reviewers` string[], required
          - `team_reviewers` string[], required
      - EventReview
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.review', required
        - `metadata` EventReviewMetadata, required
          - `review_type` 'APPROVE' | 'REQUEST_CHANGES' | 'COMMENT', required
          - `reviewer` string, nullable, required
          - `message` string, nullable, required
      - EventSquash
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `metadata` EventNoMetadata, required
        - `type` 'action.squash', required
      - EventDequeue
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `metadata` EventNoMetadata, required
        - `type` 'action.dequeue', required
      - EventUpdate
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `metadata` EventNoMetadata, required
        - `type` 'action.update', required
      - EventQueuePauseCreate
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'queue.pause.create', required
        - `metadata` EventQueuePauseCreateMetadata, required
          - `reason` string, required
          - `created_by` Actor, required
            - `type` 'application' | 'user', required
            - `id` union, required
              - …
            - `name` string, required
          - `created_by_staff` boolean, required
      - EventQueuePauseUpdate
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'queue.pause.update', required
        - `metadata` EventQueuePauseUpdateMetadata, required
          - `reason` string, required
          - `updated_by` Actor, required
            - `type` 'application' | 'user', required
            - `id` union, required
              - …
            - `name` string, required
          - `updated_by_staff` boolean, required
      - EventQueuePauseDelete
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'queue.pause.delete', required
        - `metadata` EventQueuePauseDeleteMetadata, required
          - `deleted_by` Actor, required
            - `type` 'application' | 'user', required
            - `id` union, required
              - …
            - `name` string, required
          - `deleted_by_staff` boolean, required
      - EventQueueChange
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.queue.change', required
        - `metadata` EventQueueChangeMetadata, required
          - `queue_name` string, required
          - `priority_rule_name` string, nullable, required
          - `size` integer, required
      - EventQueueChecksChange
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'action.queue.checks.change', required
        - `metadata` EventQueueChecksChangeMetadata, required
          - `queue_name` string, required
          - `running_checks` integer, required
      - EventScheduledFreezeCreate
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'scheduled_freeze.create', required
        - `metadata` EventScheduledFreezeCreateMetadata, required
          - `scheduled_freeze_attributes` ScheduledFreezeEventLogAttributes, required
            - `reason` string, required
            - `start` string, date-time, required
            - `end` string, date-time, nullable, required
            - `timezone` string, required
            - `matching_conditions` union[], required
              - …
            - `exclude_conditions` union[], required
              - …
          - `created_by` Actor, required
            - `type` 'application' | 'user', required
            - `id` union, required
              - …
            - `name` string, required
          - `created_at` string, date-time, required
          - `created_by_staff` boolean, required
      - EventScheduledFreezeUpdate
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'scheduled_freeze.update', required
        - `metadata` EventScheduledFreezeUpdateMetadata, required
          - `scheduled_freeze_attributes_before` ScheduledFreezeEventLogAttributes, required
            - `reason` string, required
            - `start` string, date-time, required
            - `end` string, date-time, nullable, required
            - `timezone` string, required
            - `matching_conditions` union[], required
              - …
            - `exclude_conditions` union[], required
              - …
          - `scheduled_freeze_attributes_after` ScheduledFreezeEventLogAttributes, required
            - `reason` string, required
            - `start` string, date-time, required
            - `end` string, date-time, nullable, required
            - `timezone` string, required
            - `matching_conditions` union[], required
              - …
            - `exclude_conditions` union[], required
              - …
          - `updated_by` Actor, required
            - `type` 'application' | 'user', required
            - `id` union, required
              - …
            - `name` string, required
          - `updated_at` string, date-time, required
          - `updated_by_staff` boolean, required
      - EventScheduledFreezeDelete
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'scheduled_freeze.delete', required
        - `metadata` EventScheduledFreezeDeleteMetadata, required
          - `scheduled_freeze_attributes` ScheduledFreezeEventLogAttributes, required
            - `reason` string, required
            - `start` string, date-time, required
            - `end` string, date-time, nullable, required
            - `timezone` string, required
            - `matching_conditions` union[], required
              - …
            - `exclude_conditions` union[], required
              - …
          - `reason` string, required
          - `deleted_by` Actor, required
            - `type` 'application' | 'user', required
            - `id` union, required
              - …
            - `name` string, required
          - `deleted_at` string, date-time, required
          - `deleted_by_staff` boolean, required
      - EventCiInsightsJobRetried
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'ci_insights.job_retried', required
        - `metadata` EventCiInsightsJobRetriedMetadata, required
          - `rule_id` string, uuid, required
          - `rule_name` string, required
          - `max_retry` integer, required
          - `retry_mode` 'job' | 'pipeline', required
          - `retry_attempt` integer, required
          - `condition_matches` union[], required
            - union
              - …
          - `outcome` 'retried' | 'skipped_quota_exceeded', required
          - `workflow_run_id` integer, nullable, required
          - `job_url` string, nullable, required
      - EventCiInsightsAutoQuarantineEnabled
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'ci_insights.auto_quarantine.enabled', required
        - `metadata` EventCiInsightsAutoQuarantineEnabledMetadata, required
          - `enabled_by` Actor, required
            - `type` 'application' | 'user', required
            - `id` union, required
              - …
            - `name` string, required
          - `enabled_at` string, date-time, required
          - `auto_quarantine_config_attributes` AutoQuarantineConfigEventLogAttributes, required
            - `ignore_broken_on_default_branch` boolean, required
          - `enabled_by_staff` boolean, required
      - EventCiInsightsAutoQuarantineDisabled
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'ci_insights.auto_quarantine.disabled', required
        - `metadata` EventCiInsightsAutoQuarantineDisabledMetadata, required
          - `disabled_by` Actor, required
            - `type` 'application' | 'user', required
            - `id` union, required
              - …
            - `name` string, required
          - `disabled_at` string, date-time, required
          - `auto_quarantine_config_attributes` AutoQuarantineConfigEventLogAttributes, required
            - `ignore_broken_on_default_branch` boolean, required
          - `disabled_by_staff` boolean, required
      - EventCiInsightsAutoQuarantineModified
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'ci_insights.auto_quarantine.modified', required
        - `metadata` EventCiInsightsAutoQuarantineModifiedMetadata, required
          - `updated_by` Actor, required
            - `type` 'application' | 'user', required
            - `id` union, required
              - …
            - `name` string, required
          - `updated_at` string, date-time, required
          - `auto_quarantine_config_attributes_before` AutoQuarantineConfigEventLogAttributes, required
            - `ignore_broken_on_default_branch` boolean, required
          - `auto_quarantine_config_attributes_after` AutoQuarantineConfigEventLogAttributes, required
            - `ignore_broken_on_default_branch` boolean, required
          - `updated_by_staff` boolean, required
      - EventCommandQueue
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'command.queue', required
        - `metadata` EventCommandMetadata, required
          - `author` GitHubAccount, required
            - `login` string, required
            - `id` integer, required
            - `type` 'User' | 'Organization' | 'Bot' | 'Mannequin' | 'Enterprise', nullable, required
            - `avatar_url` string, nullable
          - `comment_id` integer, required
          - `session_id` string, uuid, nullable, required
          - `command_trigger` 'comment' | 'checkbox', nullable, required
          - `trigger_comment_url` string, nullable, required
      - EventCommandDequeue
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'command.dequeue', required
        - `metadata` EventCommandMetadata, required
          - `author` GitHubAccount, required
            - `login` string, required
            - `id` integer, required
            - `type` 'User' | 'Organization' | 'Bot' | 'Mannequin' | 'Enterprise', nullable, required
            - `avatar_url` string, nullable
          - `comment_id` integer, required
          - `session_id` string, uuid, nullable, required
          - `command_trigger` 'comment' | 'checkbox', nullable, required
          - `trigger_comment_url` string, nullable, required
      - EventProductEnabled
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'product.enabled', required
        - `metadata` EventProductEnabledMetadata, required
          - `product` 'ci_insights' | 'merge_protections' | 'workflow_automation' | 'merge_queue', required
          - `enabled_by` Actor, required
            - `type` 'application' | 'user', required
            - `id` union, required
              - …
            - `name` string, required
          - `enabled_at` string, date-time, required
          - `enabled_by_staff` boolean, required
      - EventProductDisabled
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'product.disabled', required
        - `metadata` EventProductDisabledMetadata, required
          - `product` 'ci_insights' | 'merge_protections' | 'workflow_automation' | 'merge_queue', required
          - `disabled_by` Actor, required
            - `type` 'application' | 'user', required
            - `id` union, required
              - …
            - `name` string, required
          - `disabled_at` string, date-time, required
          - `disabled_by_staff` boolean, required
      - EventTestQuarantined
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'test.quarantined', required
        - `metadata` EventTestQuarantinedMetadata, required
          - `quarantine_id` string, uuid, required
          - `test_id` string, uuid
          - `test_name` string, required
          - `source` 'manual' | 'auto', required
          - `reason` string, required
          - `branch` string, nullable, required
          - `quarantined_at` string, date-time, required
          - `health_status_at_event` 'healthy' | 'flaky' | 'broken', required
          - `quarantined_by` Actor, required
            - `type` 'application' | 'user', required
            - `id` union, required
              - …
            - `name` string, required
          - `quarantined_by_staff` boolean, required
      - EventTestDequarantined
        - `id` integer, required
        - `received_at` string, date-time, required
        - `trigger` string, required
        - `repository` string, required
        - `pull_request` integer, nullable, required
        - `base_ref` string, nullable, required
        - `outcome` 'success' | 'failure' | 'pending' | 'neutral', required
        - `type` 'test.dequarantined', required
        - `metadata` EventTestDequarantinedMetadata, required
          - `quarantine_id` string, uuid, required
          - `test_id` string, uuid
          - `test_name` string, required
          - `source` 'manual' | 'auto', required
          - `original_quarantine` TestQuarantineSnapshot, required
            - `source` 'manual' | 'auto', required
            - `reason` string, required
            - `branch` string, nullable, required
            - `created_at` string, date-time, required
          - `health_status_at_event` 'healthy' | 'flaky' | 'broken', required
          - `dequarantined_at` string, date-time, required
          - `dequarantined_by` Actor, required
            - `type` 'application' | 'user', required
            - `id` union, required
              - …
            - `name` string, required
          - `dequarantined_by_staff` boolean, required

## Other responses

- `403` — Forbidden
- `404` — Not found
- `409` — Conflict
- `422` — Unprocessable entity

---

[API](https://skmtc.net/mergify/apis/mergify-api.md) · [All operations](https://skmtc.net/mergify/apis/mergify-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mergify/mergify-api/revisions/ae394a06c465/schema)