Update an organization variable

PATCH

/orgs/{org}/actions/variables/{name}

Updates an organization variable that you can reference in a GitHub Actions workflow.

Authenticated users must have collaborator access to a repository to create, update, or read variables.

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

API method documentation

Parameters

Path Parameters

org

required

string

The organization name. The name is not case sensitive.

name

required

string

The name of the variable.

Request Body ^required

Media type application/json

object

name

The name of the variable.

string

value

The value of the variable.

string

visibility

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.

string

Allowed values: all private selected

selected_repository_ids

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.

Array<integer>

Examples

Example default

{
  "name": "USERNAME",
  "value": "octocat",
  "visibility": "selected",
  "selected_repository_ids": [
    1296269,
    1296280
  ]
}

Responses

204

Response