Skip to content

Create an environment variable

POST
/repos/{owner}/{repo}/environments/{environment_name}/variables

Create an environment 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 tokens and personal access tokens (classic) need the repo scope to use this endpoint.

API method documentation

owner
required
string

The account owner of the repository. The name is not case sensitive.

repo
required
string

The name of the repository without the .git extension. The name is not case sensitive.

environment_name
required
string

The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.

Media type application/json
object
name
required

The name of the variable.

string
value
required

The value of the variable.

string
Examples
Example default
{
"name": "USERNAME",
"value": "octocat"
}

Response

Media type application/json
Empty Object

An object without any properties.

object
Examples
Example default
null