---
title: "Trigger a rule manually"
method: POST
path: "/api/v1/rules/trigger"
tags: ["Automation Rules"]
---

# Trigger a rule manually

`POST /api/v1/rules/trigger`

## Request

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

Manually trigger an automation rule for testing or one-off execution.

## Request body

- TriggerRuleRequest
  - `trigger_type` 'schedule' | 'watch' | 'event', required: Type of trigger to simulate
  - `event_type` string: Event type (required for event triggers)
  - `event_data` object: Event payload data
  - `tenant_id` string, uuid: Tenant UUID (required for event triggers)

## Response `200`

Rule triggered

- 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)