---
title: "Trigger immediate execution of a rule set"
method: POST
path: "/api/v1/rule_sets/{id}/execute"
tags: ["Rule Sets"]
---

# Trigger immediate execution of a rule set

`POST /api/v1/rule_sets/{id}/execute`

## Request

- Base URL: `https://getscaleforge.com`
- URL: `https://getscaleforge.com/api/v1/rule_sets/{id}/execute`
- Auth: HTTP bearer

Enqueues `RuleSchedulerJob` to run the rule set right now, bypassing its schedule. Requires scope `rules:write`.

## Response `200`

Queued

- object
  - `data` object
    - `id` integer
    - `status` string

## Other responses

- `404`: Rule set not found

---

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