Create a registration token for an organization

POST

/orgs/{org}/actions/runners/registration-token

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

For example, you can replace TOKEN in the following example with the registration token provided by this endpoint to configure your self-hosted runner:

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

Authenticated users must have admin access to the organization to use this endpoint.

OAuth tokens and personal access tokens (classic) need theadmin:org scope to use this endpoint. If the repository is private, OAuth tokens and personal access tokens (classic) need the repo scope to use this endpoint.

リクエストパラメータ

パスパラメータ

レスポンス

🟢201Created

application/json

Response

ボディapplication/json

リクエストExample

Shell

JavaScript

Java

Swift

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

レスポンスExample

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

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

List runner applications for an organization

Create a remove token for an organization