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 |
|
object (Common header included in all public events) |
|
|
object (Repository) |
|
|
object (PullRequest) |
|
|
|
string (Error message of the merge failure) |
header
|
Field |
Description |
|
|
string (Unique identifier for this event instance) |
|
|
string (Event type) |
|
|
string <date-time> (When the event occurred) |
|
|
string (ID of the primary entity this event is about) |
|
|
string (Type of the primary entity (derived from event_type)) |
|
object (Public metadata) |
|
|
|
string (Organization context) |
|
|
string (Repository context) |
|
object (UserEmbedded) |
|
|
|
string |
|
|
string |
header.metadata
|
Field |
Description |
|
|
string |
header.triggered_by
|
Field |
Description |
|
|
string (Id will contain "<external-user>" if user is external) |
|
|
string (Slug will contain "<external-user>" if user is external) |
repository
|
Field |
Description |
|
|
string |
|
|
string |
|
|
string |
|
object (OrganizationEmbedded) |
|
|
|
string |
|
|
string (RepoTemplate) Enum: |
|
|
boolean |
|
|
string |
|
|
string (Repository.Visibility) Enum: |
|
object (Image) |
|
|
object (CloneURL) |
|
|
|
string |
|
Array of objects (Link) |
|
|
object (RepositoryCounters) |
|
|
|
string <date-time> |
|
object (Language) |
|
|
object (RepositoryEmbedded) |
|
|
object (MigrationSource) |
|
|
object (ProjectEmbedded) |
|
|
object (RepositoryRating) |
|
|
object (RepositorySettings) |
repository.organization
|
Field |
Description |
|
|
string |
|
|
string |
repository.logo
|
Field |
Description |
|
|
string |
repository.clone_url
|
Field |
Description |
|
|
string |
|
|
string |
repository.links
|
Field |
Description |
|
|
string |
|
|
string (Link.LinkType) Enum: |
repository.counters
|
Field |
Description |
|
|
string <uint64> |
|
|
string <uint64> |
|
|
string <uint64> |
|
|
string <uint64> |
|
|
string <uint64> |
repository.language
|
Field |
Description |
|
|
string |
|
|
string |
repository.parent
|
Field |
Description |
|
|
string |
|
|
string |
|
object (OrganizationEmbedded) |
repository.parent.organization
|
Field |
Description |
|
|
string |
|
|
string |
repository.migration_source
|
Field |
Description |
|
|
string |
|
|
string |
repository.project
|
Field |
Description |
|
|
string |
|
|
string |
repository.rating
|
Field |
Description |
|
|
number <double> |
|
|
number <double> |
|
Array of objects (RepositoryRatingReactionCount) |
repository.rating.reaction_counts
|
Field |
Description |
|
|
string (RepositoryRatingReaction.Type)
Enum: |
|
|
string <uint64> |
repository.settings
|
Field |
Description |
|
|
boolean |
pull_request
|
Field |
Description |
|
|
string |
|
|
string |
|
object (UserEmbedded) |
|
|
object (UserEmbedded) |
|
|
|
string |
|
|
string |
|
object (RepositoryEmbedded) |
|
|
object (MergeInfo) |
|
|
|
string (Deprecated, use |
|
|
string (Deprecated, use |
|
|
string (PullRequest.Status) Enum: |
|
|
string <date-time> |
|
|
string <date-time> |
|
Array of objects (LabelEmbedded) |
|
|
object (PullRequestBranch) |
|
|
object (PullRequestBranch) |
pull_request.author
|
Field |
Description |
|
|
string (Id will contain "<external-user>" if user is external) |
|
|
string (Slug will contain "<external-user>" if user is external) |
pull_request.updated_by
|
Field |
Description |
|
|
string (Id will contain "<external-user>" if user is external) |
|
|
string (Slug will contain "<external-user>" if user is external) |
pull_request.repository
|
Field |
Description |
|
|
string |
|
|
string |
|
object (OrganizationEmbedded) |
pull_request.repository.organization
|
Field |
Description |
|
|
string |
|
|
string |
pull_request.merge_info
|
Field |
Description |
|
object (UserEmbedded) |
|
|
object (MergeParameters) |
|
|
|
string |
|
|
string (filled after merge) |
|
|
string (filled after merge) |
pull_request.merge_info.merger
|
Field |
Description |
|
|
string (Id will contain "<external-user>" if user is external) |
|
|
string (Slug will contain "<external-user>" if user is external) |
pull_request.merge_info.merge_parameters
|
Field |
Description |
|
|
boolean |
|
|
boolean |
pull_request.labels
|
Field |
Description |
|
|
string |
|
|
string |
|
|
string |
|
|
string |
pull_request.source
|
Field |
Description |
|
|
string ("org/repo:branch-name") |
|
|
string (branch name) |
|
|
string (commit SHA (hex)) |
pull_request.target
|
Field |
Description |
|
|
string ("org/repo:branch-name") |
|
|
string (branch name) |
|
|
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)"
}
}
}
}
}
}