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

Set selected repositories for an organization variable

Replaces all repositories for an organization 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.

RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters · 1 body field

orgstringrequired

The organization name. The name is not case sensitive.

namestringrequired

The name of the variable.

selected_repository_idsarray<integer>required

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

2 status codes

204Response

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

Error handling

A 409 is returned: Response when the visibility of the variable is not set to selected.

import { Client } from "acme-sdk";

const client = new Client({
  baseUrl: "https://api.acme.com",
  auth: { bearer: process.env.API_TOKEN },
  retry: {
    maxAttempts: 3,
    retryOn: [
      408,
      425,
      429,
      500,
      502,
      503,
      504,
    ],
    backoffMs: 500,
    maxBackoffMs: 8000,
  },
  timeoutMs: 30000,
});

const result = await client.repositories.update({
  org: "acme-inc",
  name: "Untitled",
  selectedRepositoryIds: "hello-world",
});

Request

Response

Errors