Create a repository dispatch event

You can use this endpoint to trigger a webhook event called repository_dispatch when you want activity that happens outside of GitHub Enterprise Server to trigger a GitHub Actions workflow or GitHub App webhook. You must configure your GitHub Actions workflow or GitHub App to run when the repository_dispatch event occurs. For an example repository_dispatch webhook payload, see "RepositoryDispatchEvent."

The client_payload parameter is available for any extra information that your workflow might need. This parameter is a JSON payload that will be passed on when the webhook event is dispatched. For example, the client_payload can include a message that a user would like to send using a GitHub Actions workflow. Or the client_payload can be used as a test to debug your workflow.

This endpoint requires write access to the repository by providing either:

Personal access tokens with repo scope. For more information, see "Creating a personal access token for the command line" in the GitHub Help documentation.

GitHub Apps with both metadata:read and contents:read&write permissions.

This input example shows how you can use the client_payload as a test to debug your workflow.

curl --location --request POST 'https://api.github.com/repos///dispatches' \ --header 'Content-Type: application/json' \ --data-raw '{ "client_payload": { "integration": true, "unit": false }, "event_type": "on-demand-test" }'

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

owner

string

必需

repo

string

必需

Body 参数application/json

client_payload

object

可选

JSON payload with extra information about the webhook event that your action or worklow may use.

额外字段

integer | number | string | boolean

可选

event_type

string

必需

A custom webhook event name.

>= 1 字符<= 100 字符

示例

Create a repository dispatch event

请求参数

返回响应