Webhook 事件和负载

了解每个 Webhook 事件何时发生以及负载包含的内容。

本文内容

关于 Webhook 事件和负载

您可以创建订阅此页面上列出的事件的 Webhook。为了限制服务器的 HTTP 请求数量，您应该只订阅您计划处理的特定事件。有关更多信息，请参阅“创建 Webhook”。

此页面上的每个 Webhook 事件都包含该事件的 Webhook 属性的描述。如果事件有多个操作，则包含与每个操作对应的属性。

每个事件仅对特定类型的 Webhook 可用。例如，组织 Webhook 可以订阅 `team` 事件，但仓库 Webhook 不可以。每个 Webhook 事件的描述都列出了该事件的可用性。有关更多信息，请参阅“Webhook 类型”。

负载上限

负载上限为 25 MB。如果事件生成更大的负载，GitHub 将不会交付该 Webhook 事件的负载。例如，如果一次推送许多分支或标签，则在 `create` 事件中可能会发生这种情况。我们建议您监控负载大小以确保交付。

交付报头

交付到您的 Webhook 配置的 URL 端点的 HTTP POST 负载将包含多个特殊报头。

  • `X-GitHub-Hook-ID`：Webhook 的唯一标识符。
  • `X-GitHub-Event`：触发交付的事件名称。
  • `X-GitHub-Delivery`：全局唯一标识符 (GUID)，用于标识事件。
  • `X-Hub-Signature`：如果 Webhook 使用 `secret` 进行配置，则会发送此报头。这是请求正文的 HMAC 十六进制摘要，它是使用 SHA-1 哈希函数和 `secret` 作为 HMAC `key` 生成的。`X-Hub-Signature` 用于与现有集成兼容。我们建议您改用更安全的 `X-Hub-Signature-256`。
  • `X-Hub-Signature-256`：如果 Webhook 使用 `secret` 进行配置，则会发送此报头。这是请求正文的 HMAC 十六进制摘要，它是使用 SHA-256 哈希函数和 `secret` 作为 HMAC `key` 生成的。有关更多信息，请参阅“验证 Webhook 交付”。
  • `User-Agent`：此报头将始终以 `GitHub-Hookshot/` 为前缀。
  • `X-GitHub-Hook-Installation-Target-Type`：创建 Webhook 的资源类型。
  • `X-GitHub-Hook-Installation-Target-ID`：创建 Webhook 的资源的唯一标识符。

要查看 Webhook 负载中每个报头可能是什么样子，请参阅“Webhook 交付示例”。

Webhook 交付示例

您可以选择以 JSON 格式 ( `application/json` ) 或 URL 编码数据 ( `x-www-form-urlencoded` ) 交付负载。下面是一个使用 JSON 格式的 Webhook POST 请求示例。

> POST /payload HTTP/2

> X-GitHub-Delivery: 72d3162e-cc78-11e3-81ab-4c9367dc0958
> X-Hub-Signature: sha1=7d38cdd689735b008b3c702edd92eea23791c5f6
> X-Hub-Signature-256: sha256=d57c68ca6f92289e6987922ff26938930f6e66a2d161ef06abdf1859230aa23c
> User-Agent: GitHub-Hookshot/044aadd
> Content-Type: application/json
> Content-Length: 6615
> X-GitHub-Event: issues
> X-GitHub-Hook-ID: 292430182
> X-GitHub-Hook-Installation-Target-ID: 79929171
> X-GitHub-Hook-Installation-Target-Type: repository

> {
>   "action": "opened",
>   "issue": {
>     "url": "https://api.github.com/repos/octocat/Hello-World/issues/1347",
>     "number": 1347,
>     ...
>   },
>   "repository" : {
>     "id": 1296269,
>     "full_name": "octocat/Hello-World",
>     "owner": {
>       "login": "octocat",
>       "id": 1,
>       ...
>     },
>     ...
>   },
>   "sender": {
>     "login": "octocat",
>     "id": 1,
>     ...
>   }
> }

branch_protection_configuration

当仓库的分支保护配置发生更改时，会发生此事件。有关更多信息，请参阅“关于受保护分支”。有关使用 API 管理分支保护规则的信息，请参阅 GraphQL 文档中的“分支保护规则”或 REST API 文档中的“分支保护”。

要订阅此事件，GitHub App 必须至少具有“管理”仓库权限的读取级访问权限。

`branch_protection_configuration` 的可用性

  • 仓库
  • 组织
  • GitHub Apps

`branch_protection_configuration` 的 Webhook 负载对象

仓库的所有分支保护均已禁用。

Webhook 请求正文参数
action 字符串 必需

值： `disabled`

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

branch_protection_rule

当与分支保护规则相关的活动发生时，会发生此事件。有关更多信息，请参阅“关于受保护分支”。有关管理分支保护规则的 API 信息，请参阅 GraphQL 文档 或 REST API 文档中的“分支保护”。

要订阅此事件，GitHub App 必须至少具有“管理”仓库权限的读取级访问权限。

`branch_protection_rule` 的可用性

  • 仓库
  • 组织
  • GitHub Apps

`branch_protection_rule` 的 Webhook 负载对象

创建了一个分支保护规则。

Webhook 请求正文参数
action 字符串 必需

值：创建

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

rule 对象 必填

分支保护规则。包括一个name和应用于与名称匹配的分支的所有分支保护设置。二元设置是布尔值。多级配置是off、non_admins或everyone之一。参与者和构建列表是字符串数组。

sender 对象 必需

GitHub 用户。

check_run

当与检查运行相关的活动发生时，将发生此事件。有关检查运行的信息，请参阅“检查 API 入门”。有关管理检查运行的 API 信息，请参阅GraphQL API 文档或 REST API 文档中的“检查运行”。

对于与检查套件相关的活动，请使用check-suite事件。

要订阅此事件，GitHub 应用必须至少具有“检查”存储库权限的读取级别访问权限。要接收rerequested和requested_action事件类型，该应用必须至少具有“检查”权限的写入级别访问权限。具有“检查”权限的写入级别访问权限的 GitHub 应用会自动订阅此 Webhook 事件。

存储库和组织 Webhook 仅接收存储库中created和completed事件类型的有效负载。

注意

API 仅查找创建检查运行的存储库中的推送。对派生存储库中分支的推送不会被检测到，并返回一个空的pull_requests数组和一个null值的head_branch。

check_run 的可用性

  • 仓库
  • 组织
  • GitHub Apps

check_run 的 Webhook 有效负载对象

检查运行已完成，并且结论可用。

Webhook 请求正文参数
action 字符串

值：completed

check_run 对象 必填

对给定代码更改的代码执行的检查

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

check_suite

当与检查套件相关的活动发生时，将发生此事件。有关检查套件的信息，请参阅“检查 API 入门”。有关管理检查套件的 API 信息，请参阅GraphQL API 文档或 REST API 文档中的“检查套件”。

对于与检查运行相关的活动，请使用check_run事件。

要订阅此事件，GitHub 应用必须至少具有“检查”权限的读取级别访问权限。要接收requested和rerequested事件类型，该应用必须至少具有“检查”权限的写入级别访问权限。具有“检查”权限的写入级别访问权限的 GitHub 应用会自动订阅此 Webhook 事件。

存储库和组织 Webhook 仅接收存储库中completed事件类型的有效负载。

注意

API 仅查找创建检查套件的存储库中的推送。对派生存储库中分支的推送不会被检测到，并返回一个空的pull_requests数组和一个null值的head_branch。

check_suite 的可用性

  • 仓库
  • 组织
  • GitHub Apps

check_suite 的 Webhook 有效负载对象

检查套件中的所有检查运行都已完成，并且结论可用。

Webhook 请求正文参数
action 字符串 必需

值：completed

check_suite 对象 必填
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

code_scanning_alert

当存储库中与代码扫描警报相关的活动发生时，将发生此事件。有关更多信息，请参阅“关于代码扫描”和“关于代码扫描警报”。有关管理代码扫描的 API 信息，请参阅 REST API 文档中的“代码扫描”。

要订阅此事件，GitHub 应用必须至少具有“代码扫描警报”存储库权限的读取级别访问权限。

code_scanning_alert 的可用性

  • 仓库
  • 组织
  • GitHub Apps

code_scanning_alert 的 Webhook 有效负载对象

先前创建的代码扫描警报出现在另一个分支中。当将分支合并到具有预先存在的代码扫描警报的分支中或从中创建分支时，可能会发生这种情况。

Webhook 请求正文参数
action 字符串 必需

值：出现在分支中

alert 对象 必填

事件中涉及的代码扫描警报。

commit_oid 字符串 必填

代码扫描警报的提交 SHA。当操作为reopened_by_user或closed_by_user时，该事件由sender触发，此值将为空。

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

ref 字符串 必填

代码扫描警报的 Git 引用。当操作为reopened_by_user或closed_by_user时，该事件由sender触发，此值将为空。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

commit_comment

当与提交注释相关的活动发生时，将发生此事件。有关提交注释的更多信息，请参阅“在拉取请求中发表评论”。有关管理提交注释的 API 信息，请参阅GraphQL API 文档或 REST API 文档中的“提交注释”。

对于与拉取请求审查评论相关的活动，请使用pull_request_review_comment事件。对于与问题评论相关的活动，请使用issue_comment事件。对于与讨论评论相关的活动，请使用discussion_comment事件。

要订阅此事件，GitHub 应用必须至少具有“内容”存储库权限的读取级别访问权限。

commit_comment 的可用性

  • 仓库
  • 组织
  • GitHub Apps

commit_comment 的 Webhook 有效负载对象

有人评论了提交。

Webhook 请求正文参数
action 字符串 必需

执行的操作。可以是创建。

值：创建

comment 对象 必填

提交注释资源。

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

create

创建 Git 分支或标签时会发生此事件。

要订阅此事件，GitHub 应用必须至少具有“内容”存储库权限的读取级别访问权限。

注意:

  • 一次创建超过三个标签时，不会发生此事件。
  • 有效负载上限为 25 MB。如果事件生成更大的有效负载，GitHub 将不会交付该 Webhook 事件的有效负载。例如，如果同时推送许多分支或标签，则可能会发生这种情况。我们建议您监控有效负载大小以确保交付。

create 的可用性

  • 仓库
  • 组织
  • GitHub Apps

create 的 Webhook 有效负载对象

Webhook 请求正文参数
description 字符串或 null 必填

存储库的当前描述。

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

master_branch 字符串 必填

存储库默认分支的名称（通常为main）。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

pusher_type 字符串 必填

事件的推送器类型。可以是user或部署密钥。

ref 字符串 必填

git ref资源。

ref_type 字符串 必填

在存储库中创建的 Git ref 对象的类型。

可以是以下之一：tag、branch

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

custom_property

当与自定义属性相关的活动发生时，将发生此事件。

有关更多信息，请参阅“管理组织中存储库的自定义属性”。有关管理自定义属性的 API 信息，请参阅 REST API 文档中的“自定义属性”。

要订阅此事件，GitHub 应用必须至少具有“自定义属性”组织权限的读取级别访问权限。

custom_property 的可用性

  • 组织
  • GitHub Apps

custom_property 的 Webhook 有效负载对象

创建了一个新的自定义属性。

Webhook 请求正文参数
action 字符串 必需

值：创建

definition 对象 必填

在组织上定义的自定义属性

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

sender 对象

GitHub 用户。

custom_property_values

当与存储库的自定义属性值相关的活动发生时，将发生此事件。

有关更多信息，请参阅“管理组织中存储库的自定义属性”。有关管理存储库自定义属性的 API 信息，请参阅 REST API 文档中的“自定义属性”。

要订阅此事件，GitHub 应用必须至少具有“自定义属性”组织权限的读取级别访问权限。

custom_property_values 的可用性

  • 仓库
  • 组织
  • GitHub Apps

custom_property_values 的 Webhook 有效负载对象

存储库的自定义属性值已更新。

Webhook 请求正文参数
action 字符串 必需

值：更新

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

organization 对象 必填

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

sender 对象

GitHub 用户。

new_property_values 对象数组 必填

仓库的新自定义属性值。

old_property_values 对象数组 必填

仓库的旧自定义属性值。

delete

当删除 Git 分支或标签时，会发生此事件。要订阅对仓库的所有推送（包括分支和标签删除），请使用 push webhook 事件。

要订阅此事件，GitHub 应用必须至少具有“内容”存储库权限的读取级别访问权限。

注意

一次删除三个以上标签时，不会发生此事件。

delete 的可用性

  • 仓库
  • 组织
  • GitHub Apps

delete 的 Webhook payload 对象

Webhook 请求正文参数
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

pusher_type 字符串 必填

事件的推送器类型。可以是user或部署密钥。

ref 字符串 必填

git ref资源。

ref_type 字符串 必填

在仓库中删除的 Git ref 对象的类型。

可以是以下之一：tag、branch

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

dependabot_alert

与 Dependabot 警报相关的活动发生时，会发生此事件。

有关 Dependabot 警报的更多信息，请参阅“关于 Dependabot 警报”。有关管理 Dependabot 警报的 API 信息，请参阅 REST API 文档中的“Dependabot 警报”。

要订阅此事件，GitHub App 必须至少具有“Dependabot 警报”仓库权限的读取级别访问权限。

注意

Dependabot 警报的 Webhook 事件目前处于公开预览阶段，可能会发生更改。

dependabot_alert 的可用性

  • 仓库
  • 组织
  • GitHub Apps

dependabot_alert 的 Webhook payload 对象

Dependabot 自动分类规则自动关闭了一个 Dependabot 警报。

Webhook 请求正文参数
action 字符串 必需

值：auto_dismissed

alert 对象 必填

一个 Dependabot 警报。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

deploy_key

与部署密钥相关的活动发生时，会发生此事件。有关更多信息，请参阅“管理部署密钥”。有关管理部署密钥的 API 信息，请参阅 GraphQL API 文档 或 REST API 文档中的“部署密钥”。

要订阅此事件，GitHub App 必须至少具有“部署”仓库权限的读取级别访问权限。

deploy_key 的可用性

  • 仓库
  • 组织
  • GitHub Apps

deploy_key 的 Webhook payload 对象

创建了一个部署密钥。

Webhook 请求正文参数
action 字符串 必需

值：创建

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

key 对象 必填

部署密钥 资源。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

deployment

与部署相关的活动发生时，会发生此事件。有关更多信息，请参阅“关于部署”。有关管理部署的 API 信息，请参阅 GraphQL API 文档 或 REST API 文档中的“部署”。

有关部署状态的活动，请使用 deployment_status 事件。

要订阅此事件，GitHub App 必须至少具有“部署”仓库权限的读取级别访问权限。

deployment 的可用性

  • 仓库
  • 组织
  • GitHub Apps

deployment 的 Webhook payload 对象

创建了一个部署。

Webhook 请求正文参数
action 字符串 必需

值：创建

deployment 对象 必填
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

workflow 对象或 null 必填
workflow_run 对象或 null 必填

deployment_protection_rule

与部署保护规则相关的活动发生时，会发生此事件。有关更多信息，请参阅“使用环境进行部署”。有关管理部署保护规则的 API 信息，请参阅 REST API 文档。

要订阅此事件，GitHub App 必须至少具有“部署”仓库权限的读取级别访问权限。

deployment_protection_rule 的可用性

  • GitHub Apps

deployment_protection_rule 的 Webhook payload 对象

已为环境请求部署保护规则。

Webhook 请求正文参数
action 字符串

值：requested

environment 字符串

具有部署保护规则的环境的名称。

event 字符串

触发部署保护规则的事件。

deployment_callback_url 字符串

查看部署保护规则的 URL。

deployment 对象

请求部署特定 ref（分支、sha、标签）。

pull_requests 对象数组
repository 对象

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

sender 对象

GitHub 用户。

deployment_review

与部署评审相关的活动发生时，会发生此事件。有关更多信息，请参阅“关于部署”。有关管理部署的 API 信息，请参阅 GraphQL API 文档 或 REST API 文档中的“部署”。

有关部署创建或部署状态的活动，请使用 deployment 或 deployment_status 事件。

要订阅此事件，GitHub App 必须至少具有“部署”仓库权限的读取级别访问权限。

deployment_review 的可用性

  • GitHub Apps

deployment_review 的 Webhook payload 对象

部署评审已获批准。

Webhook 请求正文参数
action 字符串 必需

值：approved

approver 对象
comment 字符串
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象 必填

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

reviewers 对象数组
sender 对象 必需

GitHub 用户。

since 字符串 必填
workflow_job_run 对象
workflow_job_runs 对象数组
workflow_run 对象或 null 必填

deployment_status

与部署状态相关的活动发生时，会发生此事件。有关更多信息，请参阅“关于部署”。有关管理部署的 API 信息，请参阅 GraphQL API 文档 或 REST API 文档中的“部署”。

有关部署创建的活动，请使用 deployment 事件。

要订阅此事件，GitHub App 必须至少具有“部署”仓库权限的读取级别访问权限。

注意

不会为状态为 inactive 的部署状态触发 Webhook 事件。

deployment_status 的可用性

  • 仓库
  • 组织
  • GitHub Apps

deployment_status 的 Webhook payload 对象

创建了一个新的部署状态。

Webhook 请求正文参数
action 字符串 必需

值：创建

check_run 对象或 null
deployment 对象 必填
deployment_status 对象 必填
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

workflow 对象或 null
workflow_run 对象或 null

discussion

与讨论相关的活动发生时，会发生此事件。有关讨论的更多信息，请参阅“GitHub 讨论”。有关管理讨论的 API 信息，请参阅 GraphQL 文档。

有关讨论评论的活动，请使用 discussion_comment 事件。

要订阅此事件，GitHub App 必须至少具有“讨论”仓库权限的读取级别访问权限。

注意

GitHub 讨论的 Webhook 事件目前处于公开预览阶段，可能会发生更改。

discussion 的可用性

  • 仓库
  • 组织
  • GitHub Apps

discussion 的 Webhook payload 对象

讨论中的评论已被标记为答案。

Webhook 请求正文参数
action 字符串 必需

值：answered

answer 对象 必填
discussion 对象 必填

仓库中的讨论。

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

discussion_comment

与讨论评论相关的活动发生时，会发生此事件。有关讨论的更多信息，请参阅“GitHub 讨论”。有关管理讨论的 API 信息，请参阅 GraphQL 文档。

有关讨论（而不是讨论中的评论）的活动，请使用 discussion 事件。

要订阅此事件，GitHub App 必须至少具有“讨论”仓库权限的读取级别访问权限。

注意

GitHub 讨论的 Webhook 事件目前处于公开预览阶段，可能会发生更改。

discussion_comment 的可用性

  • 仓库
  • 组织
  • GitHub Apps

discussion_comment 的 Webhook payload 对象

创建了一个讨论评论。

Webhook 请求正文参数
action 字符串 必需

值：创建

comment 对象 必填
discussion 对象 必填

仓库中的讨论。

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

fork

有人分叉仓库时，会发生此事件。有关更多信息，请参阅“分叉仓库”。有关管理分叉的 API 信息，请参阅 REST API 文档中的“分叉”。

要订阅此事件，GitHub 应用必须至少具有“内容”存储库权限的读取级别访问权限。

fork 的可用性

  • 企业
  • 仓库
  • 组织
  • GitHub Apps

fork 的 Webhook payload 对象

Webhook 请求正文参数
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

forkee 对象 必填

创建的 仓库 资源。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

github_app_authorization

用户撤销其对 GitHub App 的授权时，会发生此事件。有关更多信息，请参阅“关于 App”。有关管理 GitHub App 的 API 信息，请参阅 GraphQL API 文档 或 REST API 文档中的“App”。

GitHub App 默认会接收此 Webhook，并且无法取消订阅此事件。

任何人都可以从其GitHub 账户设置页面撤销其对 GitHub 应用的授权。撤销 GitHub 应用的授权不会卸载该应用。您应该为您的 GitHub 应用编写程序，以便当它接收到此 Webhook 时，它会停止代表撤销令牌的用户调用 API。如果您的 GitHub 应用继续使用已撤销的访问令牌，它将收到401 Bad Credentials错误。有关需要 GitHub 应用授权的用户访问令牌请求的详细信息，请参阅"代表用户使用 GitHub 应用进行身份验证"。

github_app_authorization 的可用性

  • GitHub Apps

github_app_authorization 的 Webhook有效负载对象

有人撤销了其对 GitHub 应用的授权。

Webhook 请求正文参数
action 字符串 必需

值：revoked

sender 对象 必需

GitHub 用户。

gollum

当有人创建或更新 wiki 页面时，会发生此事件。有关更多信息，请参阅"关于 wiki"。

要订阅此事件，GitHub 应用必须至少具有“内容”存储库权限的读取级别访问权限。

gollum 的可用性

  • 仓库
  • 组织
  • GitHub Apps

gollum 的 Webhook 有效负载对象

Webhook 请求正文参数
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

pages 对象数组 必需

已更新的页面。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

installation

当与 GitHub 应用安装相关的活动发生时，会发生此事件。所有 GitHub 应用默认都会收到此事件。您无法手动订阅此事件。

有关 GitHub 应用的更多信息，请参阅"关于应用"。有关管理 GitHub 应用的 API 的信息，请参阅GraphQL API 文档或 REST API 文档中的"应用"。

installation 的可用性

  • GitHub Apps

installation 的 Webhook 有效负载对象

有人在用户或组织帐户上安装了 GitHub 应用。

Webhook 请求正文参数
action 字符串 必需

值：创建

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象 必需

安装

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repositories 对象数组

安装可以访问的存储库对象数组。

repository 对象

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

requester 对象或 null
sender 对象 必需

GitHub 用户。

installation_repositories

当与 GitHub 应用安装可以访问的存储库相关的活动发生时，会发生此事件。所有 GitHub 应用默认都会收到此事件。您无法手动订阅此事件。

有关 GitHub 应用的更多信息，请参阅"关于应用"。有关管理 GitHub 应用的 API 的信息，请参阅GraphQL API 文档或 REST API 文档中的"应用"。

installation_repositories 的可用性

  • GitHub Apps

installation_repositories 的 Webhook 有效负载对象

GitHub 应用安装已授予对一个或多个存储库的访问权限。

Webhook 请求正文参数
action 字符串 必需

值：added

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象 必需

安装

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repositories_added 对象数组 必需

已添加到安装的存储库对象数组。

repositories_removed 对象数组 必需

已从安装中删除的存储库对象数组。

repository 对象

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

repository_selection 字符串 必需

描述是否已选择所有存储库或是否涉及选择。

可以是以下之一：all，selected

requester 对象或 null 必需
sender 对象 必需

GitHub 用户。

installation_target

当与安装 GitHub 应用的用户或组织帐户相关的活动发生时，会发生此事件。有关更多信息，请参阅"关于应用"。有关管理 GitHub 应用的 API 的信息，请参阅GraphQL API 文档或 REST API 文档中的"应用"。

installation_target 的可用性

  • GitHub Apps

installation_target 的 Webhook 有效负载对象

有人重命名了安装 GitHub 应用的用户或组织帐户。

Webhook 请求正文参数
account 对象 必需
action 字符串 必需

值：renamed

changes 对象 必需
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象 必需

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象

GitHub 用户。

target_type 字符串 必需

issue_comment

当与问题或拉取请求上的评论相关的活动发生时，会发生此事件。有关问题和拉取请求的更多信息，请参阅"关于问题"和"关于拉取请求"。有关管理问题评论的 API 的信息，请参阅GraphQL 文档或 REST API 文档中的"问题评论"。

对于与问题相关的活动（而不是问题上的评论），请使用issue事件。对于与拉取请求审查或拉取请求审查评论相关的活动，请使用pull_request_review或pull_request_review_comment事件。有关不同类型的拉取请求评论的更多信息，请参阅"使用评论"。

要订阅此事件，GitHub 应用必须至少具有“问题”存储库权限的读取级别访问权限。

issue_comment 的可用性

  • 仓库
  • 组织
  • GitHub Apps

issue_comment 的 Webhook 有效负载对象

在问题或拉取请求上创建了一个评论。

Webhook 请求正文参数
action 字符串 必需

值：创建

comment 对象 必填

评论本身。评论

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

issue 对象 必需

评论所属的问题。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

issues

当与问题相关的活动发生时，会发生此事件。有关问题的更多信息，请参阅"关于问题"。有关管理问题的 API 的信息，请参阅GraphQL 文档或 REST API 文档中的"问题"。

对于与问题上的评论相关的活动，请使用issue_comment事件。

要订阅此事件，GitHub 应用必须至少具有“问题”存储库权限的读取级别访问权限。

issues 的可用性

  • 仓库
  • 组织
  • GitHub Apps

issues 的 Webhook 有效负载对象

一个问题已分配给用户。

Webhook 请求正文参数
action 字符串 必需

执行的操作。

值：assigned

assignee 对象或 null
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

issue 对象 必需

问题本身。问题

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

label

当与标签相关的活动发生时，会发生此事件。有关更多信息，请参阅"管理标签"。有关管理标签的 API 的信息，请参阅GraphQL 文档或 REST API 文档中的"标签"。

如果您想在将标签添加到问题、拉取请求或讨论或从中删除标签时接收事件，请改为使用issues、pull_request或discussion事件的labeled或unlabeled操作类型。

要订阅此事件，GitHub 应用必须至少具有“元数据”存储库权限的读取级别访问权限。

label 的可用性

  • 仓库
  • 组织
  • GitHub Apps

label 的 Webhook 有效负载对象

创建了一个标签。

Webhook 请求正文参数
action 字符串 必需

值：创建

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

label 对象 必需
organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象

GitHub 用户。

marketplace_purchase

当与 GitHub Marketplace 购买相关的活动发生时，会发生此事件。有关更多信息，请参阅"GitHub Marketplace"。有关管理 GitHub Marketplace 列表的 API 的信息，请参阅GraphQL 文档或 REST API 文档中的"GitHub Marketplace"。

marketplace_purchase 的可用性

  • GitHub Marketplace

marketplace_purchase 的 Webhook 有效负载对象

有人取消了 GitHub Marketplace 计划，并且最后一个账单周期已结束。更改将立即对帐户生效。

Webhook 请求正文参数
action 字符串 必需

值：cancelled

effective_date 字符串 必需
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

marketplace_purchase 对象 必需
organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

previous_marketplace_purchase 对象
repository 对象

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

member

当仓库的协作者发生活动时，就会触发此事件。更多信息，请参见“向组织中的仓库添加外部协作者”。有关管理仓库协作者的 API 的更多信息，请参见GraphQL API 文档或 REST API 文档中的协作者。

要订阅此事件，GitHub 应用必须至少具有“成员”组织权限的读取级别访问权限。

member 的可用性

  • 企业
  • 仓库
  • 组织
  • GitHub Apps

member 的 Webhook 负载对象

GitHub 用户接受了仓库的邀请。

Webhook 请求正文参数
action 字符串 必需

值：added

changes 对象
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

member 对象或 null 必需
organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

membership

当团队成员资格发生活动时，就会触发此事件。更多信息，请参见“关于团队”。有关管理团队成员资格的 API 的更多信息，请参见GraphQL API 文档或 REST API 文档中的团队成员。

要订阅此事件，GitHub 应用必须至少具有“成员”组织权限的读取级别访问权限。

membership 的可用性

  • 组织
  • 企业
  • GitHub Apps

membership 的 Webhook 负载对象

组织成员被添加到团队。

Webhook 请求正文参数
action 字符串 必需

值：added

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

member 对象或 null 必需
organization 对象 必填

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

scope 字符串 必需

成员资格的范围。目前，只能是team。

值：team

sender 对象或 null 必需
team 对象 必需

组织成员组，可在指定的仓库中授予权限。

merge_group

当合并队列中的合并组发生活动时，就会触发此事件。更多信息，请参见“管理合并队列”。

要订阅此事件，GitHub 应用必须至少具有“合并队列”仓库权限的读取级别访问权限。

merge_group 的可用性

  • GitHub Apps

merge_group 的 Webhook 负载对象

已为合并组请求状态检查。当创建合并组或合并队列添加合并组（因为已排队拉取请求）时，就会发生这种情况。

收到此事件后，应对 head SHA 执行检查，并使用检查运行或提交状态报告状态。

Webhook 请求正文参数
action 字符串 必需

值：checks_requested

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

merge_group 对象 必需

合并队列已组合在一起以进行合并的一组拉取请求。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象

GitHub 用户。

meta

当 Webhook 本身发生活动时，就会触发此事件。

要订阅此事件，GitHub 应用必须至少具有“元数据”应用权限的读取级别访问权限。

meta 的可用性

  • GitHub Marketplace
  • 企业
  • 仓库
  • 组织
  • GitHub Apps

meta 的 Webhook 负载对象

Webhook 已删除。

Webhook 请求正文参数
action 字符串 必需

值：deleted

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

hook 对象 必需

已修改的 Webhook。这将包含基于其类型的不同键：仓库、组织、业务、应用或 GitHub Marketplace。

hook_id 整数 必需

已修改 Webhook 的 ID。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象

GitHub 用户。

milestone

当里程碑发生活动时，就会触发此事件。更多信息，请参见“关于里程碑”。有关管理里程碑的 API 信息，请参见GraphQL 文档或 REST API 文档中的里程碑。

如果要在将问题或拉取请求添加到里程碑或从里程碑中移除时接收事件，请改用issues或pull_request事件的milestoned或demilestoned操作类型。

要订阅此事件，GitHub 应用必须至少具有“问题”或“拉取请求”仓库权限的读取级别访问权限。

milestone 的可用性

  • 仓库
  • 组织
  • GitHub Apps

milestone 的 Webhook 负载对象

里程碑已关闭。

Webhook 请求正文参数
action 字符串 必需

值：closed

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

milestone 对象 必需

一组相关的 Issue 和 Pull Request。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

org_block

当组织所有者或版主阻止或取消阻止非成员在组织的仓库上进行协作时，就会触发此事件。更多信息，请参见“阻止组织中的用户”。有关管理被阻止用户的 API 信息，请参见GraphQL 文档或 REST API 文档中的阻止用户。

如果要在将成员添加到组织或从组织中移除成员时接收事件，请改用organization事件。

要订阅此事件，GitHub 应用必须至少具有“管理”组织权限的读取级别访问权限。

org_block 的可用性

  • 组织
  • 企业
  • GitHub Apps

org_block 的 Webhook 负载对象

用户已被阻止进入组织。

Webhook 请求正文参数
action 字符串 必需

值：blocked

blocked_user 对象或 null 必需
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象 必填

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

organization

当组织及其成员发生活动时，就会触发此事件。更多信息，请参见“关于组织”。有关管理组织的 API 信息，请参见GraphQL 文档或 REST API 文档中的组织。

如果要在阻止或取消阻止非成员进入组织时接收事件，请改用org_block事件。

要订阅此事件，GitHub 应用必须至少具有“成员”组织权限的读取级别访问权限。

organization 的可用性

  • 组织
  • 企业
  • GitHub Apps

organization 的 Webhook 负载对象

组织已删除。

Webhook 请求正文参数
action 字符串 必需

值：deleted

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

membership 对象

用户和组织之间的成员关系。当操作为member_invited时，不会出现。

organization 对象 必填

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

package

当 GitHub Packages 发生活动时，就会触发此事件。更多信息，请参见“GitHub Packages 简介”。有关管理 GitHub Packages 的 API 信息，请参见GraphQL API 文档或 REST API 文档中的Packages。

要在 GitHub 应用上安装此事件，该应用必须至少具有“Packages”仓库权限的读取级别访问权限。

package 的可用性

  • 仓库
  • 组织
  • GitHub Apps

package 的 Webhook 负载对象

软件包已发布到注册表。

Webhook 请求正文参数
action 字符串 必需

值：published

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

package 对象 必需

有关软件包的信息。

repository 对象

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

page_build

此事件在尝试构建 GitHub Pages 站点时发生。无论构建是否成功，都会发生此事件。有关更多信息，请参阅“配置 GitHub Pages 站点的发布源”。有关管理 GitHub Pages 的 API 信息，请参阅 REST API 文档中的“Pages”。

要订阅此事件，GitHub 应用必须至少具有“Pages”存储库权限的读取级别访问权限。

page_build 的可用性

  • 仓库
  • 组织
  • GitHub Apps

page_build 的 Webhook 负载对象

Webhook 请求正文参数
build 对象 必需
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

id 整数 必需
installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

personal_access_token_request

当有活动与请求细粒度个人访问令牌以访问属于需要批准令牌访问的资源所有者的资源相关时，会发生此事件。有关更多信息，请参阅“创建个人访问令牌”。

要订阅此事件，GitHub 应用必须至少具有“个人访问令牌请求”组织权限的读取级别访问权限。

注意

细粒度 PAT 处于公开预览阶段。相关的 API、事件和功能可能会更改。

personal_access_token_request 的可用性

  • GitHub Apps

personal_access_token_request 的 Webhook 负载对象

细粒度个人访问令牌请求已获批准。

Webhook 请求正文参数
action 字符串 必需

值：approved

personal_access_token_request 对象 必需

个人访问令牌请求的详细信息。

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

organization 对象 必填

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

sender 对象 必需

GitHub 用户。

installation 对象 必需

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

ping

创建新的 Webhook 时会发生此事件。ping 事件是 GitHub 对您已正确配置 Webhook 的确认。

ping 的可用性

  • 仓库
  • 组织
  • GitHub Apps
  • 企业
  • GitHub Marketplace

ping 的 Webhook 负载对象

Webhook 请求正文参数
hook 对象

正在 ping 的 Webhook

hook_id 整数

触发 ping 的 Webhook 的 ID。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象

GitHub 用户。

zen 字符串

GitHub zen 的随机字符串。

project_card

当项目（经典）上的卡片有活动时，会发生此事件。有关更多信息，请参阅“关于项目（经典）”。有关管理经典项目的 API 信息，请参阅GraphQL API 文档或 REST API 文档中的“项目（经典）”。

对于与项目（经典）或项目（经典）上的列相关的活动，请使用project和project_column事件。

此事件仅与项目（经典）相关。对于与新的项目体验相关的活动，请改用projects_v2事件。

要订阅此事件，GitHub 应用必须至少具有“项目”存储库或组织权限的读取级别访问权限。

project_card 的可用性

  • 仓库
  • 组织
  • GitHub Apps

project_card 的 Webhook 负载对象

项目（经典）中的备注已转换为问题。

Webhook 请求正文参数
action 字符串 必需

值：converted

changes 对象 必需
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

project_card 对象 必需
repository 对象

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

project

当项目（经典）有活动时，会发生此事件。有关更多信息，请参阅“关于项目（经典）”。有关管理经典项目的 API 信息，请参阅GraphQL API 文档或 REST API 文档中的“项目（经典）”。

对于与项目（经典）上的卡片或列相关的活动，请使用project_card和project_column事件。

此事件仅与项目（经典）相关。对于与新的项目体验相关的活动，请改用projects_v2事件。

要订阅此事件，GitHub 应用必须至少具有“项目”存储库或组织权限的读取级别访问权限。

project 的可用性

  • 仓库
  • 组织
  • GitHub Apps

project 的 Webhook 负载对象

项目（经典）已关闭。

Webhook 请求正文参数
action 字符串 必需

值：closed

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

project 对象 必需
repository 对象

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

project_column

当项目（经典）上的列有活动时，会发生此事件。有关更多信息，请参阅“关于项目（经典）”。有关管理经典项目的 API 信息，请参阅GraphQL API 文档或 REST API 文档中的“项目（经典）”。

对于与项目（经典）或项目（经典）上的卡片相关的活动，请使用project和project_card事件。

此事件仅与项目（经典）相关。对于与新的项目体验相关的活动，请改用projects_v2事件。

要订阅此事件，GitHub 应用必须至少具有“项目”存储库或组织权限的读取级别访问权限。

project_column 的可用性

  • 仓库
  • 组织
  • GitHub Apps

project_column 的 Webhook 负载对象

已向项目（经典）添加列。

Webhook 请求正文参数
action 字符串 必需

值：创建

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

project_column 对象 必需
repository 对象

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象

GitHub 用户。

projects_v2

当组织级别项目有活动时，会发生此事件。有关更多信息，请参阅“关于项目”。有关项目 API 的信息，请参阅GraphQL 文档。

对于与项目上的项目相关的活动，请使用projects_v2_item事件。对于与项目（经典）相关的活动，请改用project、project_card和project_column事件。

要订阅此事件，GitHub 应用必须至少具有“项目”组织权限的读取级别访问权限。

注意

项目的 Webhook 事件目前处于公开预览阶段，可能会有所更改。要与 GitHub 分享关于项目 Webhook 的反馈，请参阅项目 Webhook 反馈讨论。

projects_v2 的可用性

  • 组织

projects_v2 的 Webhook 负载对象

组织中的项目已关闭。

Webhook 请求正文参数
action 字符串 必需

值：closed

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象 必填

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

projects_v2 对象 必需

projects v2 项目

sender 对象 必需

GitHub 用户。

projects_v2_item

当组织级别项目上的项目有活动时，会发生此事件。有关更多信息，请参阅“关于项目”。有关项目 API 的信息，请参阅GraphQL 文档。

对于与项目（而不是项目上的项目）相关的活动，请使用projects_v2事件。对于与项目（经典）相关的活动，请改用project、project_card和project_column事件。

要订阅此事件，GitHub 应用必须至少具有“项目”组织权限的读取级别访问权限。

注意

项目的 Webhook 事件目前处于公开预览阶段，可能会有所更改。要与 GitHub 分享关于项目 Webhook 的反馈，请参阅项目 Webhook 反馈讨论。

projects_v2_item 的可用性

  • 组织

projects_v2_item 的 Webhook 负载对象

组织项目上的项目已存档。有关更多信息，请参阅“从项目中存档项目”。

Webhook 请求正文参数
action 字符串 必需

值：archived

changes 对象 必需
installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象 必填

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

projects_v2_item 对象 必需

属于项目的项目

sender 对象 必需

GitHub 用户。

projects_v2_status_update

当组织级别项目上的状态更新有活动时，会发生此事件。有关更多信息，请参阅“关于项目”。

对于与项目相关的活动，请使用projects_v2事件。

要订阅此事件，GitHub 应用必须至少具有“项目”组织权限的读取级别访问权限。

注意

要与 GitHub 分享关于项目 Webhook 的反馈，请参阅项目 Webhook 反馈讨论。

projects_v2_status_update 的可用性

  • 组织

projects_v2_status_update 的 Webhook 负载对象

已向组织中的项目添加状态更新。

Webhook 请求正文参数
action 字符串 必需

值：创建

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象 必填

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

projects_v2_status_update 对象 必需

属于项目的狀態更新

sender 对象 必需

GitHub 用户。

public

当存储库可见性从私有更改为公有时，会发生此事件。有关更多信息，请参阅“设置存储库可见性”。

要订阅此事件，GitHub 应用必须至少具有“元数据”存储库权限的读取级别访问权限。

public 的可用性

  • 仓库
  • 组织
  • GitHub Apps

public 的 Webhook 负载对象

Webhook 请求正文参数
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

pull_request

当拉取请求有活动时，会发生此事件。有关更多信息，请参阅“关于拉取请求”。有关管理拉取请求的 API 信息，请参阅GraphQL API 文档或 REST API 文档中的“Pulls”。

对于与拉取请求审查、拉取请求审查评论、拉取请求评论或拉取请求审查线程相关的活动，请改用pull_request_review、pull_request_review_comment、issue_comment或pull_request_review_thread事件。

要订阅此事件，GitHub App 必须至少具有“拉取请求”存储库权限的读取级别访问权限。

pull_request 的可用性

  • 仓库
  • 组织
  • GitHub Apps

pull_request 的 Webhook 负载对象

一个拉取请求被分配给了一个用户。

Webhook 请求正文参数
action 字符串 必需

值：assigned

assignee 对象或 null 必填
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

number 整数 必填

拉取请求编号。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

pull_request 对象 必填
repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

pull_request_review_comment

当有与拉取请求审查评论相关的活动时，就会发生此事件。拉取请求审查评论是对拉取请求差异的评论。有关更多信息，请参见“对拉取请求发表评论”。有关管理拉取请求审查评论的 API 的信息，请参见GraphQL API 文档或 REST API 文档中的“拉取请求审查评论”。

对于与拉取请求审查、拉取请求评论或拉取请求审查线程相关的活动，请改用pull_request_review、issue_comment或pull_request_review_thread事件。

要订阅此事件，GitHub App 必须至少具有“拉取请求”存储库权限的读取级别访问权限。

pull_request_review_comment 的可用性

  • 仓库
  • 组织
  • GitHub Apps

pull_request_review_comment 的 Webhook 负载对象

在拉取请求差异上创建了一个评论。

Webhook 请求正文参数
action 字符串 必需

值：创建

comment 对象 必填

评论本身。评论

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

pull_request 对象 必填
repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

pull_request_review

当有与拉取请求审查相关的活动时，就会发生此事件。拉取请求审查是一组拉取请求审查评论，以及正文评论和状态。有关更多信息，请参见“关于拉取请求审查”。有关管理拉取请求审查的 API 的信息，请参见GraphQL API 文档或 REST API 文档中的“拉取请求审查”。

对于与拉取请求审查评论、拉取请求评论或拉取请求审查线程相关的活动，请改用pull_request_review_comment、issue_comment或pull_request_review_thread事件。

要订阅此事件，GitHub App 必须至少具有“拉取请求”存储库权限的读取级别访问权限。

pull_request_review 的可用性

  • 仓库
  • 组织
  • GitHub Apps

pull_request_review 的 Webhook 负载对象

对拉取请求的审查被驳回了。

Webhook 请求正文参数
action 字符串 必需

值：dismissed

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

pull_request 对象 必填
repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

review 对象 必填

受影响的审查。

sender 对象 必需

GitHub 用户。

pull_request_review_thread

当有与拉取请求上的评论线程相关的活动时，就会发生此事件。有关更多信息，请参见“关于拉取请求审查”。有关管理拉取请求审查的 API 的信息，请参见GraphQL API 文档或 REST API 文档中的“拉取请求审查评论”。

对于与拉取请求审查评论、拉取请求评论或拉取请求审查相关的活动，请改用pull_request_review_comment、issue_comment或pull_request_review事件。

要订阅此事件，GitHub App 必须至少具有“拉取请求”存储库权限的读取级别访问权限。

pull_request_review_thread 的可用性

  • 仓库
  • 组织
  • GitHub Apps

pull_request_review_thread 的 Webhook 负载对象

拉取请求上的评论线程被标记为已解决。

Webhook 请求正文参数
action 字符串 必需

值：resolved

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

pull_request 对象 必填
repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象

GitHub 用户。

thread 对象 必填

push

当向存储库分支推送时，就会发生此事件。这包括推送提交、推送提交标签、删除分支、删除标签或从模板创建存储库时。要仅订阅分支和标签删除，请使用delete Webhook 事件。

要订阅此事件，GitHub 应用必须至少具有“内容”存储库权限的读取级别访问权限。

注意

如果一次推送超过 5000 个分支，则不会创建事件。一次推送超过三个标签时，不会为标签创建事件。

push 的可用性

  • 仓库
  • 组织
  • GitHub Apps

push 的 Webhook 负载对象

Webhook 请求正文参数
after 字符串 必填

推送后ref上最新提交的 SHA。

base_ref 字符串或 null 必填
before 字符串 必填

推送前ref上最新提交的 SHA。

commits 对象数组 必填

描述已推送提交的提交对象数组。（已推送的提交是before提交和after提交之间的compare中包含的所有提交。）该数组最多包含 2048 个提交。如有必要，您可以使用提交 API来获取其他提交。

compare 字符串 必填

显示此ref更新中更改的 URL，从before提交到after提交。对于直接基于默认分支的新创建的ref，这是默认分支的头部与after提交之间的比较。否则，这将显示直到after提交的所有提交。

created 布尔值 必填

此推送是否创建了ref。

deleted 布尔值 必填

此推送是否删除了ref。

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

forced 布尔值 必填

此推送是否是ref的强制推送。

head_commit 对象或 null 必填
installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

pusher 对象 必填

Git 作者/提交者信息的元属性。

ref 字符串 必填

已推送的完整 git ref。例如：refs/heads/main 或 refs/tags/v3.14.1。

repository 对象 必需

一个 git 存储库

sender 对象

GitHub 用户。

registry_package

当 GitHub Packages 发生活动时，就会触发此事件。更多信息，请参见“GitHub Packages 简介”。有关管理 GitHub Packages 的 API 信息，请参见GraphQL API 文档或 REST API 文档中的Packages。

要在 GitHub 应用上安装此事件，该应用必须至少具有“Packages”仓库权限的读取级别访问权限。

注意

GitHub 建议您改用较新的package事件。

registry_package 的可用性

  • 仓库
  • 组织
  • GitHub Apps

registry_package 的 Webhook 负载对象

软件包已发布到注册表。

Webhook 请求正文参数
action 字符串 必需

值：published

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

registry_package 对象 必填
repository 对象

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

release

当有与发行版相关的活动时，就会发生此事件。有关更多信息，请参见“关于发行版”。有关管理发行版的 API 的信息，请参见GraphQL API 文档或 REST API 文档中的“发行版”。

要订阅此事件，GitHub 应用必须至少具有“内容”存储库权限的读取级别访问权限。

release 的可用性

  • 仓库
  • 组织
  • GitHub Apps

release 的 Webhook 负载对象

保存了草稿，或者发布了发行版或预发行版，而之前没有将其保存为草稿。

Webhook 请求正文参数
action 字符串 必需

值：创建

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

release 对象 必填

发行版对象。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

repository_advisory

当有与存储库安全建议相关的活动时，就会发生此事件。有关存储库安全建议的更多信息，请参见“关于 GitHub 存储库安全建议”。

要订阅此事件，GitHub App 必须至少具有“存储库安全建议”权限的读取级别访问权限。

repository_advisory 的可用性

  • 仓库
  • 组织
  • GitHub Apps

repository_advisory 的 Webhook 负载对象

发布了一个存储库安全建议。

Webhook 请求正文参数
action 字符串 必需

值：published

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

repository_advisory 对象 必填

一个存储库安全建议。

sender 对象

GitHub 用户。

repository

当有与存储库相关的活动时，就会发生此事件。有关更多信息，请参见“关于存储库”。有关管理存储库的 API 的信息，请参见GraphQL 文档或 REST API 文档中的“存储库”。

要订阅此事件，GitHub 应用必须至少具有“元数据”存储库权限的读取级别访问权限。

repository 的可用性

  • 企业
  • 仓库
  • 组织
  • GitHub Apps

repository 的 Webhook 负载对象

一个存储库被存档了。

Webhook 请求正文参数
action 字符串 必需

值：archived

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

repository_dispatch

当 GitHub App 向/repos/{owner}/{repo}/dispatches发送POST请求时，就会发生此事件。有关更多信息，请参见创建存储库调度事件的 REST API 文档。在负载中，action将是POST /repos/{owner}/{repo}/dispatches请求正文中指定的event_type。

要订阅此事件，GitHub 应用必须至少具有“内容”存储库权限的读取级别访问权限。

repository_dispatch 的可用性

  • GitHub Apps

repository_dispatch 的 Webhook 负载对象

Webhook 请求正文参数
action 字符串 必需

POST /repos/{owner}/{repo}/dispatches请求正文中指定的event_type。

branch 字符串 必填
client_payload 对象或 null 必填

POST /repos/{owner}/{repo}/dispatches请求正文中指定的client_payload。

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象 必需

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

repository_import

当仓库导入到 GitHub 时，会发生此事件。更多信息，请参阅“使用 GitHub Importer 导入仓库”。有关管理导入的 API 的更多信息，请参阅REST API 文档。

repository_import 的可用性

  • 仓库
  • 组织

repository_import 的 Webhook 负载对象

Webhook 请求正文参数
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

status 字符串 必填

可以是以下之一：success，cancelled，failure

repository_ruleset

当与仓库规则集相关的活动发生时，会发生此事件。有关仓库规则集的更多信息，请参阅“管理规则集”。有关通过 API 管理规则集的更多信息，请参阅 GraphQL 文档中的仓库规则集或 REST API 文档中的仓库规则和组织规则。

要订阅此事件，GitHub 应用必须至少对“管理”仓库或组织权限具有读取权限。

repository_ruleset 的可用性

  • 仓库
  • 组织
  • GitHub Apps

repository_ruleset 的 Webhook 负载对象

创建了一个仓库规则集。

Webhook 请求正文参数
action 字符串 必需

值：创建

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

repository_ruleset 对象 必填

一组在满足指定条件时应用的规则。

sender 对象 必需

GitHub 用户。

repository_vulnerability_alert

当仓库中与安全漏洞警报相关的活动发生时，会发生此事件。

警告

停用通知：此事件即将停用。请改用dependabot_alert事件。

repository_vulnerability_alert 的可用性

  • 仓库
  • 组织

repository_vulnerability_alert 的 Webhook 负载对象

创建了一个仓库漏洞警报。

Webhook 请求正文参数
action 字符串 必需

值：create

alert 对象 必填

易受攻击的依赖项的安全警报。

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

secret_scanning_alert

当与秘密扫描警报相关的活动发生时，会发生此事件。有关秘密扫描的更多信息，请参阅“关于秘密扫描”。有关管理秘密扫描警报的 API 信息，请参阅 REST API 文档中的“秘密扫描”。

对于与秘密扫描警报位置相关的活动，请使用secret_scanning_alert_location事件。

要订阅此事件，GitHub 应用必须至少对“秘密扫描警报”仓库权限具有读取权限。

secret_scanning_alert 的可用性

  • 仓库
  • 组织
  • GitHub Apps

secret_scanning_alert 的 Webhook 负载对象

创建了一个秘密扫描警报。

Webhook 请求正文参数
action 字符串 必需

值：创建

alert 对象 必填
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象

GitHub 用户。

secret_scanning_alert_location

当与秘密扫描警报中秘密的位置相关的活动发生时，会发生此事件。

有关秘密扫描的更多信息，请参阅“关于秘密扫描”。有关管理秘密扫描警报的 API 信息，请参阅 REST API 文档中的“秘密扫描”。

对于与秘密扫描警报相关的活动，请使用secret_scanning_alert事件。

要订阅此事件，GitHub 应用必须至少对“秘密扫描警报”仓库权限具有读取权限。

secret_scanning_alert_location 的可用性

  • 仓库
  • 组织
  • GitHub Apps

secret_scanning_alert_location 的 Webhook 负载对象

在仓库中检测到先前检测到的秘密的新实例，并将秘密的位置添加到现有警报中。

Webhook 请求正文参数
action 字符串

值：创建

alert 对象 必填
installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

location 对象 必填
organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

security_advisory

当与 GitHub 审核的全局安全咨询相关的活动发生时，会发生此事件。GitHub 审核的全局安全咨询提供有关已映射到我们支持的生态系统中的软件包的安全漏洞或恶意软件的信息。有关全局安全咨询的更多信息，请参阅“关于全局安全咨询”。有关管理安全咨询的 API 信息，请参阅REST API 文档或GraphQL 文档。

GitHub Dependabot 警报也由安全咨询数据集提供支持。更多信息，请参阅“关于 Dependabot 警报”。

security_advisory 的可用性

  • GitHub Apps

security_advisory 的 Webhook 负载对象

安全咨询已发布到 GitHub 社区。

Webhook 请求正文参数
action 字符串 必需

值：published

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

security_advisory 对象 必填

安全咨询的详细信息，包括摘要、描述和严重性。

sender 对象

GitHub 用户。

security_and_analysis

当为仓库启用或禁用代码安全和分析功能时，会发生此事件。更多信息，请参阅“GitHub 安全功能”。

要订阅此事件，GitHub App 必须至少具有“管理”仓库权限的读取级访问权限。

security_and_analysis 的可用性

  • 仓库
  • 组织
  • GitHub Apps

security_and_analysis 的 Webhook 负载对象

Webhook 请求正文参数
changes 对象 必需
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

完整仓库

sender 对象

GitHub 用户。

sponsorship

当与赞助列表相关的活动发生时，会发生此事件。更多信息，请参阅“关于 GitHub Sponsors”。有关管理赞助商的 API 信息，请参阅GraphQL 文档。

你只能在 GitHub.com 上创建赞助 Webhook。更多信息，请参阅“为赞助帐户中的事件配置 Webhook”。

sponsorship 的可用性

  • 赞助帐户

sponsorship 的 Webhook 负载对象

赞助已取消，最后一个结算周期已结束。

仅当取消定期（每月）赞助时才会发送此事件；对于一次性赞助不会发送此事件。

Webhook 请求正文参数
action 字符串 必需

值：cancelled

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

sponsorship 对象 必填

star

当与仓库星标相关的活动发生时，会发生此事件。有关星标的更多信息，请参阅“使用星标保存仓库”。有关管理星标的 API 信息，请参阅GraphQL 文档或 REST API 文档中的“加星标”。

要订阅此事件，GitHub 应用必须至少具有“元数据”存储库权限的读取级别访问权限。

star 的可用性

  • 仓库
  • 组织
  • GitHub Apps

star 的 Webhook 负载对象

有人为仓库加了星标。

Webhook 请求正文参数
action 字符串 必需

值：创建

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

starred_at 字符串或 null 必填

创建星标的时间。这是一个 ISO 8601 格式的时间戳：YYYY-MM-DDTHH:MM:SSZ。对于deleted操作将为null。

status

当 Git 提交的状态发生更改时，会发生此事件。例如，提交可以标记为error、failure、pending或success。更多信息，请参阅“关于状态检查”。有关管理提交状态的 API 信息，请参阅GraphQL 文档或 REST API 文档中的“提交状态”。

要订阅此事件，GitHub 应用必须至少对“提交状态”仓库权限具有读取权限。

status 的可用性

  • 仓库
  • 组织
  • GitHub Apps

status 的 Webhook 负载对象

Webhook 请求正文参数
avatar_url 字符串或 null
branches 对象数组 必填

包含状态 SHA 的分支对象数组。每个分支都包含给定的 SHA，但 SHA 可能是也可能不是分支的头部。数组最多包含 10 个分支。

commit 对象 必填
context 字符串 必填
created_at 字符串 必填
description 字符串或 null 必填

添加到状态的可选人性化描述。

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

id 整数 必需

状态的唯一标识符。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

name 字符串 必填
organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

sha 字符串 必填

提交 SHA。

state 字符串 必填

新的状态。可以是pending、success、failure或error。

可以是以下之一：pending，success，failure，error

target_url 字符串或 null 必填

添加到状态的可选链接。

updated_at 字符串 必填

子问题

当发生与子问题相关的活动时，将触发此事件。

对于更普遍的问题相关活动，请使用issues事件。

要订阅此事件，GitHub App必须至少具有“问题”存储库权限的读取级别访问权限。

sub_issues 的可用性

  • 仓库
  • 组织
  • GitHub Apps

sub_issues 的Webhook有效负载对象

一个父问题已添加到问题中。

Webhook 请求正文参数
action 字符串 必需

值：parent_issue_added

parent_issue_id 数字 必填

父问题的ID。

parent_issue 对象 必填

问题是跟踪项目任务、增强功能和错误的好方法。

parent_issue_repo 对象 必填

GitHub上的一个仓库。

sub_issue_id 数字 必填

子问题的ID。

sub_issue 对象 必填

问题是跟踪项目任务、增强功能和错误的好方法。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象

GitHub 用户。

团队添加

当一个团队被添加到仓库时，将触发此事件。更多信息，请参阅“管理访问您仓库的团队和人员”。

有关团队活动的更多信息，请参阅teams事件。

要订阅此事件，GitHub 应用必须至少具有“成员”组织权限的读取级别访问权限。

team_add 的可用性

  • 仓库
  • 组织
  • GitHub Apps

team_add 的Webhook有效负载对象

Webhook 请求正文参数
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

team 对象 必需

组织成员组，可在指定的仓库中授予权限。

团队

当组织中发生与团队相关的活动时，将触发此事件。更多信息，请参阅“关于团队”。

要订阅此事件，GitHub 应用必须至少具有“成员”组织权限的读取级别访问权限。

team 的可用性

  • 组织
  • 企业
  • GitHub Apps

team 的Webhook有效负载对象

一个团队被授予对仓库的访问权限。

Webhook 请求正文参数
action 字符串 必需

值：added_to_repository

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象 必填

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象

一个 git 存储库

sender 对象

GitHub 用户。

team 对象 必需

组织成员组，可在指定的仓库中授予权限。

关注

当发生与关注或订阅仓库相关的活动时，将触发此事件。有关关注的更多信息，请参阅“管理您的订阅”。有关管理关注的API信息，请参阅REST API文档中的“关注”。

要订阅此事件，GitHub 应用必须至少具有“元数据”存储库权限的读取级别访问权限。

watch 的可用性

  • 仓库
  • 组织
  • GitHub Apps

watch 的Webhook有效负载对象

有人开始关注该仓库。

Webhook 请求正文参数
action 字符串 必需

值：started

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

工作流调度

当手动触发GitHub Actions工作流时，将触发此事件。更多信息，请参阅“手动运行工作流”。

对于与工作流运行相关的活动，请使用workflow_run事件。

要订阅此事件，GitHub 应用必须至少具有“内容”存储库权限的读取级别访问权限。

workflow_dispatch 的可用性

  • GitHub Apps

workflow_dispatch 的Webhook有效负载对象

Webhook 请求正文参数
enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

inputs 对象或null 必填
installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

ref 字符串 必填
repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

workflow 字符串 必填

工作流作业

当GitHub Actions工作流中的作业发生活动时，将触发此事件。更多信息，请参阅“在工作流中使用作业”。有关管理工作流作业的API信息，请参阅REST API文档中的“工作流作业”。

对于与工作流运行中的作业相关的活动（而不是工作流运行中的作业），请使用workflow_run事件。

要订阅此事件，GitHub App必须至少具有“Actions”存储库权限的读取级别访问权限。

workflow_job 的可用性

  • 企业
  • 仓库
  • 组织
  • GitHub Apps

workflow_job 的Webhook有效负载对象

工作流运行中的作业已完成。无论作业成功还是失败，只要工作流中的作业完成，就会触发此事件。

Webhook 请求正文参数
action 字符串 必需

值：completed

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

workflow_job 对象 必填
deployment 对象

请求部署特定 ref（分支、sha、标签）。

工作流运行

当GitHub Actions工作流的运行发生活动时，将触发此事件。更多信息，请参阅“关于工作流”。有关管理工作流运行的API信息，请参阅GraphQL文档或REST API文档中的“工作流运行”。

对于与工作流运行中的作业相关的活动，请使用workflow_job事件。

要订阅此事件，GitHub App必须至少具有“Actions”存储库权限的读取级别访问权限。

workflow_run 的可用性

  • 企业
  • 仓库
  • 组织
  • GitHub Apps

workflow_run 的Webhook有效负载对象

工作流运行已完成。无论工作流成功还是失败，只要工作流运行完成，就会触发此事件。

Webhook 请求正文参数
action 字符串 必需

值：completed

enterprise 对象

GitHub 上的企业。当 Webhook 在企业帐户或属于企业帐户的组织上配置时，Webhook 负载包含 `enterprise` 属性。有关更多信息，请参阅“关于企业帐户”。

installation 对象

GitHub App 安装。当为 GitHub App 配置并向其发送事件时，Webhook 负载包含 `installation` 属性。有关更多信息，请参阅“将 Webhook 与 GitHub Apps 配合使用”。

organization 对象

GitHub 组织。当为组织配置 Webhook 或事件来自组织拥有的仓库中的活动时，Webhook 负载包含 `organization` 属性。

repository 对象 必需

发生事件的 GitHub 仓库。当事件来自仓库中的活动时，Webhook 负载包含 `repository` 属性。

sender 对象 必需

GitHub 用户。

workflow 对象或 null 必填
workflow_run 对象 必填