---
title: "List all Automation Rules in an Environment."
method: GET
path: "/orgs/{orgId}/apps/{appId}/envs/{envId}/rules"
tags: ["public", "AutomationRule"]
---

# List all Automation Rules in an Environment.

`GET /orgs/{orgId}/apps/{appId}/envs/{envId}/rules`

## Path parameters

- `orgId` string, required
- `appId` string, required
- `envId` string, required

## Response `200`

A possibly empty array of Automation Rules

- AutomationRuleResponse[]
  - `active` boolean, required — Whether the rule will be processed or not.
  - `artefacts_filter` string[], required — A list of artefact names to be processed by the rule. If the array is empty, it implies include all. If `exclude_artefacts_filter` is true, this list describes the artefacts to exclude.
  - `created_at` string, date-time, required — The timestamp in UTC of when the Automation Rule was created.
  - `exclude_artefacts_filter` boolean, required — Whether the artefacts specified in `artefacts_filter` should be excluded (true) or included (false) in the automation rule.
  - `exclude_images_filter` boolean, required — DEPRECATED: Whether the images specified in `images_filter` should be excluded (true) or included (false) in the automation rule.
  - `id` string, required — The unique ID for this rule.
  - `images_filter` string[], required — DEPRECATED: A list of image IDs to be processed by the rule. If the array is empty, it implies include all. If `exclude_images_filter` is true, this list describes images to exclude.
  - `match` string, required — DEPRECATED: A regular expression applied to the branch or tag name depending on the value of `update_to`. Defaults to match all if omitted or empty.
  - `match_ref` string, required — A regular expression applied to the ref of a new artefact version. Defaults to match all if omitted or empty.
  - `type` string, required — Specifies the type of event. Currently, only updates to either branches or tags are supported. Must be `"update"`.
  - `update_to` string, required — DEPRECATED: Specifies whether the update occurs on commit to branch or creation of tag. Must be one of `"branch"` or `"tag"`.
  - `updated_at` string, date-time, required — The timestamp in UTC of when the Automation Rule was updated.

---

[API](https://skmtc.net/humanitec/apis/humanitec-api.md) · [All operations](https://skmtc.net/humanitec/apis/humanitec-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humanitec/humanitec-api/revisions/e21ad140ec3c/schema)