agents

Create an organization variable

Changed on

Creates an organization agent 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 admin:org scope to use this endpoint. If the repository is private, OAuth tokens and personal access tokens (classic) need the repo scope to use this endpoint.

post/orgs/{org}/agents/variables

Request

  • Base URL: https://api.github.com
  • URL: https://api.github.com/orgs/{org}/agents/variables
  • Auth: none declared

Path parameters

orgstring required

The organization name. The name is not case sensitive.

Request body

namestring required

The name of the variable.

valuestring required

The value of the variable.

visibility'all' | 'private' | 'selected' 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.

selected_repository_idsinteger[]

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.

Response

Response when creating a variable

EmptyObject required

An object without any properties.

Changes