Get an organization variable

GET

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

Gets a specific variable in an organization. You must authenticate using an access token with the admin:org scope to use this endpoint. GitHub Apps must have the organization_actions_variables:read organization permission to use this endpoint.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.github.com/orgs//actions/variables/'

Response Example

{
    "created_at": "2019-01-24T22:45:36.000Z",
    "name": "USERNAME",
    "selected_repositories_url": "https://api.github.com/organizations/org/variables/USERNAME/repositories",
    "updated_at": "2019-01-24T22:45:36.000Z",
    "value": "octocat",
    "visibility": "all"
}

Request

Path Params

org

string

required

The organization name. The name is not case sensitive.

name

string

required

The name of the variable.

Responses

🟢200Response

application/json

Body

Organization variable for GitHub Actions.

created_at

string <date-time>

required

The date and time at which the variable was created, in ISO 8601 format':' YYYY-MM-DDTHH:MM:SSZ.

Example:

2019-01-24T22:45:36.000Z

name

string

required

The name of the variable.

Example:

USERNAME

selected_repositories_url

string <uri>

optional

Example:

https://api.github.com/organizations/org/variables/USERNAME/repositories

updated_at

string <date-time>

required

The date and time at which the variable was last updated, in ISO 8601 format':' YYYY-MM-DDTHH:MM:SSZ.

Example:

2019-01-24T22:45:36.000Z

value

string

required

The value of the variable.

Example:

octocat

visibility

enum<string>

required

Visibility of a variable

Allowed values:

allprivateselected

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

Delete an organization variable

Update an organization variable