Request a GitHub Pages build

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.


string The token will be passed in the authorization header.




POST https://api.github.com/repos///pages/builds
authorization: bearer undefined
accept: application/vnd.github.v3+json
user-agent: octokit.rest
content-length: 0

Example Response

Status: 201
  "url": "https://api.github.com/repos/github/developer.github.com/pages/builds/latest",
  "status": "queued"

See documentation on GitHub developer guides