Set organization access for a self-hosted runner group in an enterprise

Replaces the list of organizations that have access to a self-hosted runner configured in an enterprise. You must authenticate using an access token with the `admin:enterprise` scope to use this endpoint.

PUT/enterprises/{enterprise}/actions/runner-groups/{runner_group_id}/organizations

Source: github-v3-rest.json
Revision: f5f067c1e6f6
Active snapshot: 85e53e3d0d65

Request

Path Parameters

enterprise string required: The slug version of the enterprise name. You can also substitute this value with the enterprise id.
runner_group_id integer required: Unique identifier of the self-hosted runner group.

Body Params

required

application/jsonobject

selected_organization_ids array[integer]

required

List of organization IDs that can access the runner group.

Responses

Response

Request configuration

This OpenAPI document does not declare an authentication scheme. Check the API provider's documentation before sending credentials; Manja cannot infer or validate an undocumented scheme.

Common bearer example: Authorization: Bearer YOUR_ACCESS_TOKEN

hostname

Self-hosted Enterprise Server or Enterprise Cloud hostname

protocol

Self-hosted Enterprise Server or Enterprise Cloud protocol

enterprise *

The slug version of the enterprise name. You can also substitute this value with the enterprise id.

runner_group_id *

Unique identifier of the self-hosted runner group.

Request Sample: Shell / cURL

curl --request PUT \
  --url {protocol}://{hostname}/api/v3/enterprises/{enterprise}/actions/runner-groups/{runner_group_id}/organizations \
  --header 'content-type: application/json' \
  --data '{
  "selected_organization_ids": [
    32,
    91
  ]
}'