Skip to content

Set selected repositories for an organization variable

PUT
/orgs/{org}/agents/variables/{name}/repositories

Replaces all repositories for an organization agent variable that is available to selected repositories. Organization variables that are available to selected repositories have their visibility field set to selected.

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

org
required
string

The organization name. The name is not case sensitive.

name
required
string

The name of the variable.

Media type application/json
object
selected_repository_ids
required

The IDs of the repositories that can access the organization variable.

Array<integer>
Examples
Example default
{
"selected_repository_ids": [
64780797
]
}

Response

Response when the visibility of the variable is not set to selected