capabilities.work

Register a Self-hosted Runner

A 3-step recipe with GitHub Actions. We can help you get access.

Recipe · 3 steps

Register a Self-hosted Runner

Works with AI assistants

Gather runner binaries and a registration token for a repository.

  1. List the runner application binaries available for download so the right OS/architecture package can be chosen.
  2. Create a registration token to pass to the self-hosted runner config script. Returns 201 with a token and its expiry.
  3. List the repository's currently registered self-hosted runners to confirm the existing inventory.
What you'll need to have ready
  • accessToken: GitHub bearer token with repository administration access.
  • owner: The account owner of the repository.
  • repo: The name of the repository without the .git extension.
For your developer

Arazzo workflow github-actions:register-runner, 3 operations: listRunnerApplicationsForRepo → createRegistrationTokenForRepo → listSelfHostedRunnersForRepo. Specs on APIs.io.