Skip to content

Create a repository variable

POST
/repos/{owner}/{repo}/actions/variables

Creates a repository 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.

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