---
title: "Create automation rule"
method: POST
path: "/api/v1/rules"
tags: ["Automation Rules"]
---

# Create automation rule

`POST /api/v1/rules`

## Request

- Base URL: `https://numonic.ai`
- URL: `https://numonic.ai/api/v1/rules`
- Auth: API key in header `x-api-key`

Create an automation rule that executes a pipeline when conditions are met. Triggers can be event-based (e.g., asset.created), scheduled (cron expression), or interval-based (watch polling).

## Request body

- CreateRuleRequest
  - `name` string, required
  - `description` string
  - `trigger_config` object, required: Trigger configuration (event-based, scheduled, or watch-based)
    - `type` 'event' | 'schedule' | 'watch', required
  - `rate_limit_config` object, required: Rate limit configuration
    - `max_per_minute` integer
    - `max_per_hour` integer
  - `pipeline_vars` object: Default pipeline variables

## Response `201`

Rule created

- SuccessMessage
  - `message` string, required: Human-readable success message

## Other responses

- `400`: Validation failed

---

[API](https://skmtc.dev/numonic/apis/numonic-api.md) · [All operations](https://skmtc.dev/numonic/apis/numonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/numonic/apis/numonic-api/revisions/6c559bef1e35?raw)