---
title: "List experiment rules"
method: GET
path: "/api/experimental/experiments/rules"
tags: ["General"]
---

# List experiment rules

`GET /api/experimental/experiments/rules`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/experimental/experiments/rules`
- Auth: API key in header `Coder-Session-Token`

## Response `200`

OK

- CodersdkExperimentRuleEntry[]
  - `experiment` string: Experiment is the experiment name. Ignored entries can name experiments this version does not know, so it is a plain string.
  - `ignored` boolean: Ignored is true for a stored rule of an experiment that does not accept runtime rules. Such a rule has no effect.
  - `rule` CodersdkExperimentRule
    - `condition` string: Condition is the CEL expression of a condition rule.
    - `mode` string: Mode is one of the ExperimentRuleMode values, or empty when the stored rule is malformed. A malformed rule decides off until it is replaced. It is a plain string so that clients can represent the malformed state.
    - `revision` integer: Revision increases on every change and starts at 1. Zero means the stored rule has no readable positive revision, so it is malformed.
    - `updated_at` string, date-time
    - `updated_by` string, uuid
  - `static_default` boolean: StaticDefault reports whether the experiment is in the startup --experiments list of the replica that answered.

## Changes

- **2026-09-29** `62a9d07a2fe6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/coder/apis/coder-api/changes/api/experimental/experiments/rules/get.md)

---

[API](https://skmtc.dev/coder/apis/coder-api.md) - [All operations](https://skmtc.dev/coder/apis/coder-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coder/apis/coder-api/revisions/4669d93796ab?raw)