coder
diff --git a/‎coderd/apidoc/docs.go
Lines changed: 27 additions & 7 deletions b/‎coderd/apidoc/docs.go
Lines changed: 27 additions & 7 deletions
diff --git a/‎coderd/apidoc/swagger.json
Lines changed: 23 additions & 7 deletions b/‎coderd/apidoc/swagger.json
Lines changed: 23 additions & 7 deletions
diff --git a/‎coderd/coderd.go
Lines changed: 1 addition & 0 deletions b/‎coderd/coderd.go
Lines changed: 1 addition & 0 deletions
diff --git a/‎coderd/experiments.go
Lines changed: 16 additions & 10 deletions b/‎coderd/experiments.go
Lines changed: 16 additions & 10 deletions
diff --git a/‎codersdk/deployment.go
Lines changed: 17 additions & 16 deletions b/‎codersdk/deployment.go
Lines changed: 17 additions & 16 deletions
diff --git a/‎docs/api/general.md
Lines changed: 37 additions & 6 deletions b/‎docs/api/general.md
Lines changed: 37 additions & 6 deletions
@@ -597,6 +597,7 @@ func New(options *Options) *API {
 		})
 		r.Route("/experiments", func(r chi.Router) {
 			r.Use(apiKeyMiddleware)
+			r.Get("/available", api.handleExperimentsSafe)
 			r.Get("/", api.handleExperimentsGet)
 		})
 		r.Get("/updatecheck", api.updateCheck)
 
@@ -7,22 +7,28 @@ import (
 	"github.com/coder/coder/v2/codersdk"
 )
 
-// @Summary Get experiments
-// @ID get-experiments
+// @Summary Get enabled experiments
+// @ID get-enabled-experiments
 // @Security CoderSessionToken
 // @Produce json
 // @Tags General
-// @Param include_all query bool false "All available experiments"
 // @Success 200 {array} codersdk.Experiment
 // @Router /experiments [get]
 func (api *API) handleExperimentsGet(rw http.ResponseWriter, r *http.Request) {
 	ctx := r.Context()
-	all := r.URL.Query().Has("include_all")
-
-	if !all {
-		httpapi.Write(ctx, rw, http.StatusOK, api.Experiments)
-		return
-	}
+	httpapi.Write(ctx, rw, http.StatusOK, api.Experiments)
+}
 
-	httpapi.Write(ctx, rw, http.StatusOK, codersdk.ExperimentsAll)
+// @Summary Get safe experiments
+// @ID get-safe-experiments
+// @Security CoderSessionToken
+// @Produce json
+// @Tags General
+// @Success 200 {array} codersdk.Experiment
+// @Router /experiments/available [get]
+func (api *API) handleExperimentsSafe(rw http.ResponseWriter, r *http.Request) {
+	ctx := r.Context()
+	httpapi.Write(ctx, rw, http.StatusOK, codersdk.AvailableExperiments{
+		Safe: codersdk.ExperimentsAll,
+	})
 }
@@ -2029,26 +2029,27 @@ func (e Experiments) Enabled(ex Experiment) bool {
 	return false
 }
 
-type ExperimentOptions struct {
-	// All signifies that all experiments - rather than just those that are enabled -
-	// should be returned
-	IncludeAll bool `json:"include_all,omitempty"`
+func (c *Client) Experiments(ctx context.Context) (Experiments, error) {
+	res, err := c.Request(ctx, http.MethodGet, "/api/v2/experiments", nil)
+	if err != nil {
+		return nil, err
+	}
+	defer res.Body.Close()
+	if res.StatusCode != http.StatusOK {
+		return nil, ReadBodyAsError(res)
+	}
+	var exp []Experiment
+	return exp, json.NewDecoder(res.Body).Decode(&exp)
 }
 
-// asRequestOption returns a function that can be used in (*Client).Request.
-// It modifies the request query parameters.
-func (o ExperimentOptions) asRequestOption() RequestOption {
-	return func(r *http.Request) {
-		q := r.URL.Query()
-		if o.IncludeAll {
-			q.Set("include_all", "true")
-		}
-		r.URL.RawQuery = q.Encode()
-	}
+// AvailableExperiments is an expandable type that returns all safe experiments
+// available to be used with a deployment.
+type AvailableExperiments struct {
+	Safe []Experiment `json:"safe"`
 }
 
-func (c *Client) Experiments(ctx context.Context, opts ExperimentOptions) (Experiments, error) {
-	res, err := c.Request(ctx, http.MethodGet, "/api/v2/experiments", nil, opts.asRequestOption())
+func (c *Client) SafeExperiments(ctx context.Context) (Experiments, error) {
+	res, err := c.Request(ctx, http.MethodGet, "/api/v2/experiments/available", nil)
 	if err != nil {
 		return nil, err
 	}