---
title: "List automation rules"
method: GET
path: "/api/v2/cases/projects/{project_id}/rules"
tags: ["Case Management"]
---

# List automation rules

`GET /api/v2/cases/projects/{project_id}/rules`

Returns all automation rules configured for a project. Automation rules allow automatic actions to be triggered by case events like creation, status transitions, or attribute changes.

## Path parameters

- `project_id` string, required

## Response `200`

OK

- AutomationRulesResponse — Response containing a list of automation rules for a project.
  - `data` AutomationRule[], required — List of automation rules.
    - `attributes` AutomationRuleAttributes, required — Core attributes of an automation rule, including its name, trigger condition, action to execute, and current state.
      - `action` AutomationRuleAction, required — Defines what happens when the rule triggers. Combines an action type with action-specific configuration data.
        - `data` AutomationRuleActionData, required — Configuration for the action to execute, dependent on the action type.
          - `agent_type` string — The type of AI agent to assign. Required when the action type is `assign_agent`.
          - `assigned_agent_id` string — The identifier of the AI agent to assign to the case. Required when the action type is `assign_agent`.
          - `handle` string — The handle of the Datadog workflow to execute. Required when the action type is `execute_workflow`.
        - `type` 'execute_workflow' | 'assign_agent', required — The type of automated action to perform when the rule triggers. `execute_workflow` runs a Datadog workflow; `assign_agent` assigns an AI agent to the case.
      - `created_at` string, date-time, required — Timestamp when the automation rule was created.
      - `modified_at` string, date-time — Timestamp when the automation rule was last modified.
      - `name` string, required — A human-readable name for the automation rule, used to identify the rule in the UI and API responses.
      - `state` 'ENABLED' | 'DISABLED', required — Whether the automation rule is active. Enabled rules trigger on matching case events; disabled rules are inactive but preserve their configuration.
      - `trigger` AutomationRuleTrigger, required — Defines when the rule activates. Combines a trigger type (the case event to listen for) with optional trigger data (conditions that narrow when the trigger fires).
        - `data` AutomationRuleTriggerData — Additional configuration for the trigger, dependent on the trigger type. For `status_transitioned` triggers, specify `from_status_name` and `to_status_name`. For `attribute_value_changed` triggers, specify `field` and `change_type`.
          - `approval_type` string — The approval outcome to match. Used with `case_review_approved` triggers.
          - `change_type` string — The kind of attribute change to match. Allowed values: `VALUE_ADDED`, `VALUE_DELETED`, `ANY_CHANGES`. Used with `attribute_value_changed` triggers.
          - `field` string — The case attribute field name to monitor for changes. Used with `attribute_value_changed` triggers.
          - `from_status_name` string — The originating status name. Used with `status_transitioned` triggers to match transitions from this status.
          - `to_status_name` string — The destination status name. Used with `status_transitioned` triggers to match transitions to this status.
        - `type` 'case_created' | 'status_transitioned' | 'attribute_value_changed' | 'event_correlation_signal_correlated' | 'case_review_approved' | 'comment_added', required — The case event that activates the automation rule.
    - `id` string, required — Automation rule identifier.
    - `relationships` AutomationRuleRelationships — Related resources for the automation rule, including the users who created and last modified it.
      - `created_by` NullableUserRelationship, nullable — Relationship to user.
        - `data` NullableUserRelationshipData, nullable, required — Relationship to user object.
          - `id` string, required — A unique identifier that represents the user.
          - `type` 'user', required — User resource type.
      - `modified_by` NullableUserRelationship, nullable — Relationship to user.
        - `data` NullableUserRelationshipData, nullable, required — Relationship to user object.
          - `id` string, required — A unique identifier that represents the user.
          - `type` 'user', required — User resource type.
    - `type` 'rule', required — JSON:API resource type for case automation rules.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too many requests

---

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