feat: Add repository-level immutable releases settings

github/repos_immutable_releases.go

@@ -0,0 +1,82 @@
+// Copyright 2026 The go-github AUTHORS. All rights reserved.
+//
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package github
+
+import (
+	"context"
+	"fmt"
+)
+
+// RepoImmutableReleasesStatus represents the immutable releases status for a repository.
+type RepoImmutableReleasesStatus struct {
+	Enabled         *bool `json:"enabled,omitempty"`
+	EnforcedByOwner *bool `json:"enforced_by_owner,omitempty"`
+}
+
+// EnableImmutableReleases enables immutable releases for a repository.
+//
+// GitHub API docs: https://docs.github.com/rest/repos/repos#enable-immutable-releases
+//
+//meta:operation PUT /repos/{owner}/{repo}/immutable-releases
+func (s *RepositoriesService) EnableImmutableReleases(ctx context.Context, owner, repo string) (*Response, error) {
+	u := fmt.Sprintf("repos/%v/%v/immutable-releases", owner, repo)
+
+	req, err := s.client.NewRequest("PUT", u, nil)
+	if err != nil {
+		return nil, err
+	}
+
+	resp, err := s.client.Do(ctx, req, nil)
+	if err != nil {
+		return resp, err
+	}
+
+	return resp, nil
+}
+
+// DisableImmutableReleases disables immutable releases for a repository.
+//
+// GitHub API docs: https://docs.github.com/rest/repos/repos#disable-immutable-releases
+//
+//meta:operation DELETE /repos/{owner}/{repo}/immutable-releases
+func (s *RepositoriesService) DisableImmutableReleases(ctx context.Context, owner, repo string) (*Response, error) {
+	u := fmt.Sprintf("repos/%v/%v/immutable-releases", owner, repo)
+
+	req, err := s.client.NewRequest("DELETE", u, nil)
+	if err != nil {
+		return nil, err
+	}
+
+	resp, err := s.client.Do(ctx, req, nil)
+	if err != nil {
+		return resp, err
+	}
+
+	return resp, nil
+}
+
+// AreImmutableReleasesEnabled checks if immutable releases are enabled for
+// the repository.
+//
+// GitHub API docs: https://docs.github.com/rest/repos/repos#check-if-immutable-releases-are-enabled-for-a-repository
+//
+//meta:operation GET /repos/{owner}/{repo}/immutable-releases
+func (s *RepositoriesService) AreImmutableReleasesEnabled(ctx context.Context, owner, repo string) (*RepoImmutableReleasesStatus, *Response, error) {
+	u := fmt.Sprintf("repos/%v/%v/immutable-releases", owner, repo)
+
+	req, err := s.client.NewRequest("GET", u, nil)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	var status *RepoImmutableReleasesStatus
+	resp, err := s.client.Do(ctx, req, &status)
+	if err != nil {
+		return nil, resp, err
+	}
+
+	return status, resp, nil
+}

github/repos_immutable_releases_test.go

@@ -0,0 +1,100 @@
+// Copyright 2026 The go-github AUTHORS. All rights reserved.
+//
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+package github
+
+import (
+	"fmt"
+	"net/http"
+	"testing"
+
+	"github.com/google/go-cmp/cmp"
+)
+
+func TestRepositoriesService_EnableImmutableReleases(t *testing.T) {
+	t.Parallel()
+	client, mux, _ := setup(t)
+
+	mux.HandleFunc("/repos/owner/repo/immutable-releases", func(w http.ResponseWriter, r *http.Request) {
+		testMethod(t, r, "PUT")
+		w.WriteHeader(http.StatusNoContent)
+	})
+
+	ctx := t.Context()
+	_, err := client.Repositories.EnableImmutableReleases(ctx, "owner", "repo")
+	if err != nil {
+		t.Errorf("Repositories.EnableImmutableReleases returned error: %v", err)
+	}
+
+	const methodName = "EnableImmutableReleases"
+	testBadOptions(t, methodName, func() (err error) {
+		_, err = client.Repositories.EnableImmutableReleases(ctx, "\n", "\n")
+		return err
+	})
+
+	testNewRequestAndDoFailure(t, methodName, client, func() (*Response, error) {
+		return client.Repositories.EnableImmutableReleases(ctx, "owner", "repo")
+	})
+}
+
+func TestRepositoriesService_DisableImmutableReleases(t *testing.T) {
+	t.Parallel()
+	client, mux, _ := setup(t)
+
+	mux.HandleFunc("/repos/owner/repo/immutable-releases", func(w http.ResponseWriter, r *http.Request) {
+		testMethod(t, r, "DELETE")
+		w.WriteHeader(http.StatusNoContent)
+	})
+
+	ctx := t.Context()
+	_, err := client.Repositories.DisableImmutableReleases(ctx, "owner", "repo")
+	if err != nil {
+		t.Errorf("Repositories.DisableImmutableReleases returned error: %v", err)
+	}
+
+	const methodName = "DisableImmutableReleases"
+	testBadOptions(t, methodName, func() (err error) {
+		_, err = client.Repositories.DisableImmutableReleases(ctx, "\n", "\n")
+		return err
+	})
+
+	testNewRequestAndDoFailure(t, methodName, client, func() (*Response, error) {
+		return client.Repositories.DisableImmutableReleases(ctx, "owner", "repo")
+	})
+}
+
+func TestRepositoriesService_AreImmutableReleasesEnabled(t *testing.T) {
+	t.Parallel()
+	client, mux, _ := setup(t)
+
+	mux.HandleFunc("/repos/owner/repo/immutable-releases", func(w http.ResponseWriter, r *http.Request) {
+		testMethod(t, r, "GET")
+		fmt.Fprint(w, `{"enabled": true, "enforced_by_owner": false}`)
+	})
+
+	ctx := t.Context()
+	status, _, err := client.Repositories.AreImmutableReleasesEnabled(ctx, "owner", "repo")
+	if err != nil {
+		t.Errorf("Repositories.AreImmutableReleasesEnabled returned error: %v", err)
+	}
+	want := &RepoImmutableReleasesStatus{Enabled: Ptr(true), EnforcedByOwner: Ptr(false)}
+	if !cmp.Equal(status, want) {
+		t.Errorf("Repositories.AreImmutableReleasesEnabled returned %+v, want %+v", status, want)
+	}
+
+	const methodName = "AreImmutableReleasesEnabled"
+	testBadOptions(t, methodName, func() (err error) {
+		_, _, err = client.Repositories.AreImmutableReleasesEnabled(ctx, "\n", "\n")
+		return err
+	})
+
+	testNewRequestAndDoFailure(t, methodName, client, func() (*Response, error) {
+		got, resp, err := client.Repositories.AreImmutableReleasesEnabled(ctx, "owner", "repo")
+		if got != nil {
+			t.Errorf("testNewRequestAndDoFailure %v = %#v, want nil", methodName, got)
+		}
+		return resp, err
+	})
+}