pull_request.merge_failure

PullRequestMergeFailure event - represents merge failure of a pull request

CI execution_ref: Pull request source branch.

can-trigger-ci: true

REQUEST BODY SCHEMA: application/json
required

Field

Description

header

object (Common header included in all public events)

repository

object (Repository)

pull_request

object (PullRequest)

error_message

string (Error message of the merge failure)

Field

Description

id

string (Unique identifier for this event instance)

type

string (Event type)

occurred_at

string <date-time> (When the event occurred)

aggregate_id

string (ID of the primary entity this event is about)

aggregate_type

string (Type of the primary entity (derived from event_type))

metadata

object (Public metadata)

organization_id

string (Organization context)

repository_id

string (Repository context)

triggered_by

object (UserEmbedded)

correlation_id

string
Correlation ID for tracking event chains back to the original request.
Uses request_id from the originating gRPC/HTTP request when available,
falls back to trace_id or the root event's ID.

causation_id

string
Causation ID is the ID of the event that directly caused this event.
Empty for root events (events triggered directly by user actions).
Used to reconstruct the event tree within a correlation chain.

header.metadata

Field

Description

property name*
additional property

string

header.triggered_by

Field

Description

id

string (Id will contain "<external-user>" if user is external)

slug

string (Slug will contain "<external-user>" if user is external)

repository

Field

Description

id

string

name

string
Deprecated: obsolete, prefer using slug. Will be removed in future API iterations.

default_branch

string

organization

object (OrganizationEmbedded)

slug

string

template_type

string (RepoTemplate)

Enum: "not_a_template" "organizational" "system"

is_empty

boolean

description

string

visibility

string (Repository.Visibility)

Enum: "public" "internal" "private"

logo

object (Image)

clone_url

object (CloneURL)

web_url

string

links

Array of objects (Link)

counters

object (RepositoryCounters)

last_updated

string <date-time>

language

object (Language)

parent

object (RepositoryEmbedded)

migration_source

object (MigrationSource)

project

object (ProjectEmbedded)

rating

object (RepositoryRating)
Aggregated rating information for a repository.

settings

object (RepositorySettings)

repository.organization

Field

Description

id

string

slug

string

Field

Description

url

string

repository.clone_url

Field

Description

https

string

ssh

string

Field

Description

link

string

type

string (Link.LinkType)

Enum: "default" "social_network" "homepage" "email" "telegram"

repository.counters

Field

Description

forks

string <uint64>

pull_requests

string <uint64>

issues

string <uint64>

tags

string <uint64>

branches

string <uint64>

repository.language

Field

Description

name

string

color

string

repository.parent

Field

Description

id

string

slug

string

organization

object (OrganizationEmbedded)

repository.parent.organization

Field

Description

id

string

slug

string

repository.migration_source

Field

Description

url

string

domain

string

repository.project

Field

Description

id

string

slug

string

repository.rating

Field

Description

value

number <double>
Current repository rating value.

percentile

number <double>
Repository percentile among rated repositories. Omitted while percentile data is unavailable.

reaction_counts

Array of objects (RepositoryRatingReactionCount)
Reaction counters grouped by reaction type.

repository.rating.reaction_counts

Field

Description

type

string (RepositoryRatingReaction.Type)

  • none: Remove the current user's rating reaction.
  • positive_low: A low positive rating reaction. Corresponds to Like in the SourceCraft interface.
  • positive_medium: A medium positive rating reaction. Corresponds to Heart in the SourceCraft interface.
  • positive_high: A high positive rating reaction. Corresponds to Diamond in the SourceCraft interface.

Enum: "none" "positive_low" "positive_medium" "positive_high"

count

string <uint64>

repository.settings

Field

Description

allow_external_contributions

boolean
Whether authenticated users without organization or repository access can contribute to a public repository.
Has no effect on non-public repositories.

pull_request

Field

Description

id

string

slug

string

author

object (UserEmbedded)

updated_by

object (UserEmbedded)

title

string

description

string

repository

object (RepositoryEmbedded)

merge_info

object (MergeInfo)

source_branch

string (Deprecated, use source instead)

target_branch

string (Deprecated, use target instead)

status

string (PullRequest.Status)

Enum: "draft" "open" "discarded" "merging" "merged"

created_at

string <date-time>

updated_at

string <date-time>

labels

Array of objects (LabelEmbedded)

source

object (PullRequestBranch)

target

object (PullRequestBranch)

pull_request.author

Field

Description

id

string (Id will contain "<external-user>" if user is external)

slug

string (Slug will contain "<external-user>" if user is external)

pull_request.updated_by

Field

Description

id

string (Id will contain "<external-user>" if user is external)

slug

string (Slug will contain "<external-user>" if user is external)

pull_request.repository

Field

Description

id

string

slug

string

organization

object (OrganizationEmbedded)

pull_request.repository.organization

Field

Description

id

string

slug

string

pull_request.merge_info

Field

Description

merger

object (UserEmbedded)

merge_parameters

object (MergeParameters)

target_commit_hash

string

error

string (filled after merge)

merge_commit_hash

string (filled after merge)

pull_request.merge_info.merger

Field

Description

id

string (Id will contain "<external-user>" if user is external)

slug

string (Slug will contain "<external-user>" if user is external)

pull_request.merge_info.merge_parameters

Field

Description

rebase

boolean

squash

boolean

pull_request.labels

Field

Description

id

string

slug

string

name

string

color

string

pull_request.source

Field

Description

label

string ("org/repo:branch-name")

ref

string (branch name)

sha

string (commit SHA (hex))

pull_request.target

Field

Description

label

string ("org/repo:branch-name")

ref

string (branch name)

sha

string (commit SHA (hex))

Request samples
{
  "$ref": "#/components/schemas/PullRequestMergeFailure",
  "components": {
    "schemas": {
      "PullRequestMergeFailure": {
        "type": "object",
        "properties": {
          "header": {
            "$ref": "#/components/schemas/EventHeader"
          },
          "repository": {
            "$ref": "#/components/schemas/Repository"
          },
          "pull_request": {
            "$ref": "#/components/schemas/PullRequest"
          },
          "error_message": {
            "type": "string",
            "title": "Error message of the merge failure"
          }
        },
        "title": "PullRequestMergeFailure event - represents merge failure of a pull request"
      },
      "EventHeader": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Unique identifier for this event instance"
          },
          "type": {
            "type": "string",
            "title": "Event type"
          },
          "occurred_at": {
            "type": "string",
            "format": "date-time",
            "title": "When the event occurred"
          },
          "aggregate_id": {
            "type": "string",
            "title": "ID of the primary entity this event is about"
          },
          "aggregate_type": {
            "type": "string",
            "title": "Type of the primary entity (derived from event_type)"
          },
          "metadata": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "title": "Public metadata"
          },
          "organization_id": {
            "type": "string",
            "title": "Organization context"
          },
          "repository_id": {
            "type": "string",
            "title": "Repository context"
          },
          "triggered_by": {
            "$ref": "#/components/schemas/UserEmbedded"
          },
          "correlation_id": {
            "type": "string",
            "description": "Correlation ID for tracking event chains back to the original request.\nUses request_id from the originating gRPC/HTTP request when available,\nfalls back to trace_id or the root event's ID."
          },
          "causation_id": {
            "type": "string",
            "description": "Causation ID is the ID of the event that directly caused this event.\nEmpty for root events (events triggered directly by user actions).\nUsed to reconstruct the event tree within a correlation chain."
          }
        },
        "title": "Common header included in all public events"
      },
      "UserEmbedded": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "Id will contain \"<external-user>\" if user is external"
          },
          "slug": {
            "type": "string",
            "title": "Slug will contain \"<external-user>\" if user is external"
          }
        }
      },
      "Repository": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string",
            "description": "Deprecated: obsolete, prefer using slug. Will be removed in future API iterations."
          },
          "default_branch": {
            "type": "string"
          },
          "organization": {
            "$ref": "#/components/schemas/OrganizationEmbedded"
          },
          "slug": {
            "type": "string"
          },
          "template_type": {
            "$ref": "#/components/schemas/RepoTemplate"
          },
          "is_empty": {
            "type": "boolean"
          },
          "description": {
            "type": "string"
          },
          "visibility": {
            "$ref": "#/components/schemas/Repository.Visibility"
          },
          "logo": {
            "$ref": "#/components/schemas/Image"
          },
          "clone_url": {
            "$ref": "#/components/schemas/CloneURL"
          },
          "web_url": {
            "type": "string"
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Link"
            }
          },
          "counters": {
            "$ref": "#/components/schemas/RepositoryCounters"
          },
          "last_updated": {
            "type": "string",
            "format": "date-time"
          },
          "language": {
            "$ref": "#/components/schemas/Language"
          },
          "parent": {
            "$ref": "#/components/schemas/RepositoryEmbedded"
          },
          "migration_source": {
            "$ref": "#/components/schemas/MigrationSource"
          },
          "project": {
            "$ref": "#/components/schemas/ProjectEmbedded"
          },
          "rating": {
            "$ref": "#/components/schemas/RepositoryRating"
          },
          "settings": {
            "$ref": "#/components/schemas/RepositorySettings"
          }
        }
      },
      "OrganizationEmbedded": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          }
        }
      },
      "RepoTemplate": {
        "type": "string",
        "enum": [
          "not_a_template",
          "organizational",
          "system"
        ]
      },
      "Repository.Visibility": {
        "type": "string",
        "enum": [
          "public",
          "internal",
          "private"
        ]
      },
      "Image": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          }
        }
      },
      "CloneURL": {
        "type": "object",
        "properties": {
          "https": {
            "type": "string"
          },
          "ssh": {
            "type": "string"
          }
        }
      },
      "Link": {
        "type": "object",
        "properties": {
          "link": {
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/Link.LinkType"
          }
        }
      },
      "Link.LinkType": {
        "type": "string",
        "enum": [
          "default",
          "social_network",
          "homepage",
          "email",
          "telegram"
        ]
      },
      "RepositoryCounters": {
        "type": "object",
        "properties": {
          "forks": {
            "type": "string",
            "format": "uint64"
          },
          "pull_requests": {
            "type": "string",
            "format": "uint64"
          },
          "issues": {
            "type": "string",
            "format": "uint64"
          },
          "tags": {
            "type": "string",
            "format": "uint64"
          },
          "branches": {
            "type": "string",
            "format": "uint64"
          }
        }
      },
      "Language": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "color": {
            "type": "string"
          }
        }
      },
      "RepositoryEmbedded": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "organization": {
            "$ref": "#/components/schemas/OrganizationEmbedded"
          }
        }
      },
      "MigrationSource": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          },
          "domain": {
            "type": "string"
          }
        }
      },
      "ProjectEmbedded": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          }
        }
      },
      "RepositoryRating": {
        "type": "object",
        "properties": {
          "value": {
            "type": "number",
            "format": "double",
            "description": "Current repository rating value."
          },
          "percentile": {
            "type": "number",
            "format": "double",
            "description": "Repository percentile among rated repositories. Omitted while percentile data is unavailable."
          },
          "reaction_counts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RepositoryRatingReactionCount"
            },
            "description": "Reaction counters grouped by reaction type."
          }
        },
        "description": "Aggregated rating information for a repository."
      },
      "RepositoryRatingReactionCount": {
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/RepositoryRatingReaction.Type"
          },
          "count": {
            "type": "string",
            "format": "uint64"
          }
        },
        "description": "Number of rating reactions of a particular type."
      },
      "RepositoryRatingReaction.Type": {
        "type": "string",
        "enum": [
          "none",
          "positive_low",
          "positive_medium",
          "positive_high"
        ],
        "description": " - none: Remove the current user's rating reaction.\n - positive_low: A low positive rating reaction. Corresponds to Like in the SourceCraft interface.\n - positive_medium: A medium positive rating reaction. Corresponds to Heart in the SourceCraft interface.\n - positive_high: A high positive rating reaction. Corresponds to Diamond in the SourceCraft interface."
      },
      "RepositorySettings": {
        "type": "object",
        "properties": {
          "allow_external_contributions": {
            "type": "boolean",
            "description": "Whether authenticated users without organization or repository access can contribute to a public repository.\nHas no effect on non-public repositories."
          }
        }
      },
      "PullRequest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "author": {
            "$ref": "#/components/schemas/UserEmbedded"
          },
          "updated_by": {
            "$ref": "#/components/schemas/UserEmbedded"
          },
          "title": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "repository": {
            "$ref": "#/components/schemas/RepositoryEmbedded"
          },
          "merge_info": {
            "$ref": "#/components/schemas/MergeInfo"
          },
          "source_branch": {
            "type": "string",
            "title": "Deprecated, use `source` instead"
          },
          "target_branch": {
            "type": "string",
            "title": "Deprecated, use `target` instead"
          },
          "status": {
            "$ref": "#/components/schemas/PullRequest.Status"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "labels": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LabelEmbedded"
            }
          },
          "source": {
            "$ref": "#/components/schemas/PullRequestBranch"
          },
          "target": {
            "$ref": "#/components/schemas/PullRequestBranch"
          }
        }
      },
      "MergeInfo": {
        "type": "object",
        "properties": {
          "merger": {
            "$ref": "#/components/schemas/UserEmbedded"
          },
          "merge_parameters": {
            "$ref": "#/components/schemas/MergeParameters"
          },
          "target_commit_hash": {
            "type": "string"
          },
          "error": {
            "type": "string",
            "title": "filled after merge"
          },
          "merge_commit_hash": {
            "type": "string",
            "title": "filled after merge"
          }
        }
      },
      "MergeParameters": {
        "type": "object",
        "properties": {
          "rebase": {
            "type": "boolean"
          },
          "squash": {
            "type": "boolean"
          }
        }
      },
      "PullRequest.Status": {
        "type": "string",
        "enum": [
          "draft",
          "open",
          "discarded",
          "merging",
          "merged"
        ]
      },
      "LabelEmbedded": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "color": {
            "type": "string"
          }
        }
      },
      "PullRequestBranch": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "title": "\"org/repo:branch-name\""
          },
          "ref": {
            "type": "string",
            "title": "branch name"
          },
          "sha": {
            "type": "string",
            "title": "commit SHA (hex)"
          }
        }
      }
    }
  }
}
Предыдущая
Следующая