---
title: "List all automation rules"
method: GET
path: "/sheets/{sheetId}/automationrules"
tags: ["automationRules"]
---

# List all automation rules

`GET /sheets/{sheetId}/automationrules`

Returns all automation rules associated with the specified sheet.

Multistep workflows are not returned via the API.

Instead, you'll see an error 400 - 1266: This rule is not accessible through the API.

Only single-action notifications, approval requests, or update requests qualify.

For users of Smartsheet for Slack, note that Slack notifications are not
returned.

> **Note:** For pagination guidance, refer to [Pagination](/api/smartsheet/guides/basics/pagination).

## Query parameters

- `includeAll` boolean
- `page` number
- `pageSize` number

## Response `200`

The list of AutomationRule objects.

**Note:** For pagination guidance, refer to [Pagination](/api/smartsheet/guides/basics/pagination).

- object
  - `pageNumber` number — The current page in the full result set that the data array represents. NOTE when a page number greater than totalPages is requested, the last page is instead returned.
  - `pageSize` number, nullable — The number of items in a page. Omitted if there is no limit to page size (and hence, all results are included). Unless otherwise specified, this defaults to 100 for most endpoints.
  - `totalPages` number — The total number of pages in the full result set.
  - `totalCount` number — The total number of items in the full result set.
  - `data` AutomationRule[] — list of Automation Rules
    - `id` number — AutomationRule ID.
    - `action` unknown
    - `createdAt` union
      - string, date-time
      - number
    - `createdBy` MiniUser — MiniUser Object
      - `email` string, email
      - `name` string
    - `disabledReason` 'APPROVAL_COLUMN_MISSING' | 'APPROVAL_COLUMN_WRONG_TYPE' | 'AUTOMATION_NOT_ENABLED_FOR_ORG' | 'COLUMN_MISSING' | 'COLUMN_TYPE_INCOMPATIBLE' | 'NO_POTENTIAL_RECIPIENTS' | 'NO_VALID_SELECTED_COLUMNS' — Machine-readable reason a rule is disabled: * `APPROVAL_COLUMN_MISSING` This rule's approval status column has been deleted. * `APPROVAL_COLUMN_WRONG_TYPE` The approval column must be a dropdown column. * `AUTOMATION_NOT_ENABLED_FOR_ORG` To create or edit automated actions, you need to upgrade your organization account to a Business or Enterprise plan. * `COLUMN_MISSING` A column referenced by this rule has been deleted. * `COLUMN_TYPE_INCOMPATIBLE` A column referenced by this rule has been changed to an incompatible column type. * `NO_POTENTIAL_RECIPIENTS` This rule has no recipients that will be able to receive notifications based on this sheet's permission settings or this account's approved domain sharing list. * `NO_VALID_SELECTED_COLUMNS` All selected columns for this rule have been deleted.
    - `disabledReasonText` string — Descriptive reason a rule is disabled.
    - `enabled` boolean — If true, indicates that the rule is active.
    - `modifiedAt` union
      - string, date-time
      - number
    - `modifiedBy` MiniUser — MiniUser Object
      - `email` string, email
      - `name` string
    - `name` string — Rule name as shown in the UI.
    - `userCanModify` boolean — If true, indicates that the current user can modify the rule.

---

[API](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/smartsheet-openapi-reference/versions/b4afda95fb51/schema)