Create a registration token for an enterprise

POST

/enterprises/{enterprise}/actions/runners/registration-token

Returns a token that you can pass to the config script. The token expires after one hour.

Example using registration token:

Configure your self-hosted runner, replacing TOKEN with the registration token provided by this endpoint.

./config.sh --url https://github.com/enterprises/octo-enterprise --token TOKEN

OAuth app tokens and personal access tokens (classic) need the manage_runners:enterprise scope to use this endpoint.

リクエストパラメータ

パスパラメータ

🟢201Created

application/json

Response

ボディapplication/json

リクエストExample

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://service1.exmaple.com/enterprises//actions/runners/registration-token'

レスポンスExample

{
    "token": "LLBF3JGZDX3P5PMEXLND6TS6FCWO6",
    "expires_at": "2020-01-22T12:13:35.123-08:00"
}

更新日時 2025-06-12 06:47:18