---
title: "Trigger Rule"
method: POST
path: "/api/v1/runs/rules/{rule_id}/trigger"
tags: ["run"]
---

# Trigger Rule

`POST /api/v1/runs/rules/{rule_id}/trigger`

Trigger a run rule manually.

## Path parameters

- `rule_id` string, uuid, required

## Response `200`

Successful Response

- RunRulesSchema — Run rules schema.
  - `id` string, uuid, required
  - `tenant_id` string, uuid, required
  - `is_enabled` boolean
  - `session_id` string, uuid, nullable
  - `session_name` string, nullable
  - `dataset_id` string, uuid, nullable
  - `dataset_name` string, nullable
  - `display_name` string, required
  - `sampling_rate` number, required
  - `filter` string, nullable
  - `trace_filter` string, nullable
  - `tree_filter` string, nullable
  - `add_to_annotation_queue_id` string, uuid, nullable
  - `add_to_annotation_queue_name` string, nullable
  - `add_to_dataset_id` string, uuid, nullable
  - `add_to_dataset_name` string, nullable
  - `add_to_dataset_prefer_correction` boolean
  - `corrections_dataset_id` string, uuid, nullable
  - `use_corrections_dataset` boolean
  - `num_few_shot_examples` integer, nullable
  - `evaluators` EvaluatorTopLevel[], nullable
    - `structured` EvaluatorStructuredOutput, required — Evaluator structured output schema.
      - `hub_ref` string, nullable
      - `prompt` array[], nullable
        - unknown[]
          - unknown
      - `template_format` string, nullable
      - `schema` object, nullable
      - `variable_mapping` object, nullable
      - `model` object, nullable
  - `code_evaluators` CodeEvaluatorTopLevel[], nullable
    - `code` string, required
    - `language` 'python' | 'javascript'
  - `alerts` RunRulesPagerdutyAlertSchema[], nullable
    - `type` 'pagerduty' — Enum for alert types.
    - `routing_key` string, required
    - `summary` string, nullable
    - `severity` 'critical' | 'warning' | 'error' | 'info' — Enum for severity.
  - `webhooks` RunRulesWebhookSchema[], nullable, required
    - `url` string, required
    - `headers` object, nullable
  - `extend_only` boolean
  - `include_extended_stats` boolean
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `backfill_from` string, date-time, nullable
  - `backfill_id` string, uuid, nullable
  - `backfill_status` string, nullable
  - `backfill_progress` number, nullable
  - `backfill_error` string, nullable
  - `backfill_completed_at` string, date-time, nullable
  - `transient` boolean
  - `evaluator_version` integer, required
  - `evaluator_id` string, uuid, nullable
  - `alignment_annotation_queue_id` string, uuid, nullable
  - `group_by` 'thread_id', nullable
  - `spend_limit` RunRuleSpendLimitSchemaOutput
    - `limit_usd` string, required
    - `window` 'weekly', required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/langchain-ai/apis/langsmith.md) · [All operations](https://skmtc.net/langchain-ai/apis/langsmith/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langchain-ai/langsmith/versions/a0acb3a6a101/schema)