Create an organization variable

Creates an organization variable that you can reference in a GitHub Actions workflow.
You must authenticate using an access token with the admin:org scope to use this endpoint.
GitHub Apps must have the organization_actions_variables:write organization permission to use this endpoint.

curl --location --request POST 'https://api.github.com/orgs//actions/variables' \ --header 'Content-Type: application/json' \ --data-raw '{ "name": "USERNAME", "selected_repository_ids": [ 1296269, 1296280 ], "value": "octocat", "visibility": "selected" }'

Request

Path Params

org

string

required

The organization name. The name is not case sensitive.

Body Params application/json

name

string

required

The name of the variable.

selected_repository_ids

array[integer]

optional

An array of repository ids that can access the organization variable. You can only provide a list of repository ids when the visibility is set to selected.

value

string

required

The value of the variable.

visibility

enum<string>

required

The type of repositories in the organization that can access the variable. selected means only the repositories specified by selected_repository_ids can access the variable.

Allowed values:

allprivateselected

Examples

Request

Responses