Manage access control for organization codespaces

PUT

/orgs/{org}/codespaces/billing

Sets which users can access codespaces in an organization. This is synonymous with granting or revoking codespaces billing permissions for users according to the visibility.
You must authenticate using an access token with the admin:org scope to use this endpoint.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.github.com/orgs//codespaces/billing' \
--header 'Content-Type: application/json' \
--data-raw '{
    "selected_usernames": [
        "johnDoe",
        "atomIO"
    ],
    "visibility": "selected_members"
}'

Response Example

204 - Example 1

{}

Request

Path Params

org

string

required

The organization name. The name is not case sensitive.

Body Params application/json

selected_usernames

array[string]

optional

The usernames of the organization members who should have access to codespaces in the organization. Required when visibility is selected_members. The provided list of usernames will replace any existing value.

<= 100 items

visibility

enum<string>

required

Which users can access codespaces in the organization. disabled means that no users can access codespaces in the organization.

Allowed values:

disabledselected_membersall_membersall_members_and_outside_collaborators

Examples

Responses

🟢204Response when successfully modifying permissions.

application/json

Body

object {0}

🔵304304

🟠400Users are neither members nor collaborators of this organization.

🟠404404

🟠422422

🔴500500

Modified at 2023-08-15 02:59:24

List codespaces for the organization

Removes users from Codespaces billing for an organization