Request a GitHub Pages build

POST

/repos/{owner}/{repo}/pages/builds

You can request that your site be built from the latest revision on the default branch. This has the same effect as pushing a commit to your default branch, but does not require an additional commit. Manually triggering page builds can be helpful when diagnosing build warnings and failures.

Build requests are limited to one concurrent build per repository and one concurrent build per requester. If you request a build while another is still in progress, the second request will be queued until the first completes.

Request

Path Params

Responses

🟢201Response

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.github.com/repos///pages/builds'

Response Example

{
    "status": "queued",
    "url": "https://api.github.com/repos/github/hello-world/pages/builds/latest"
}

Modified at 2023-08-15 02:59:29

List GitHub Pages builds

Get latest Pages build