---
title: "Trigger"
method: POST
path: "/api/v1/ome/trigger"
tags: ["ome"]
---

# Trigger

`POST /api/v1/ome/trigger`

Manually trigger a registered OME strategy and wait for its runs to
settle. Returns without waiting for the LanceDB index — the response
reflects markdown state only; poll ``GET /health``'s ``cascade.pending``
for index convergence (two consecutive zero samples to guard against the
watcher-input window). See docs/api.md#eventual-consistency.

## Request body

- TriggerRequest — Request body for ``POST /api/v2/ome/trigger``.
  - `name` string, required
  - `timeout` number
  - `force` boolean

## Response `200`

Successful Response

- TriggerResponse — Response body for ``POST /api/v2/ome/trigger``. ``status`` distinguishes three outcomes that were previously masked as a single ``ok``: - ``ok``: at least one strategy was dispatched and all runs settled within ``timeout``. Individual run outcomes are in ``runs`` (a ``dead_letter`` there is still ``ok`` at this level — the strategy *ran*, it just failed permanently). - ``timeout``: at least one strategy was dispatched but the engine did not go idle within ``timeout``. Runs may be partially complete; poll ``GET /health`` for cascade convergence separately. - ``not_dispatched``: no strategy was dispatched — the subscriber was rejected by one of the dispatch gates (``_routes_to`` / ``enabled`` / ``applies_to`` / ``Counter``). Common cause: forgetting ``force=true`` on a strategy that is ``enabled=false`` in ome.toml.
  - `status` string, required
  - `name` string, required
  - `dispatched` integer, required
  - `runs` RunSummary[]
    - `run_id` string, required
    - `status` string, required
    - `error` string, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-07** `67efe20bff24` — 2 info
  - added the optional property `runs` to the response with the `200` status
  - added the required property `dispatched` to the response with the `200` status
- **2026-06-24** `65f2f4743b36` — 1 info
  - endpoint added
- **2026-06-05** `7be97420eb25` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/evermind-ai/apis/everos/changes/api/v1/ome/trigger/post.md)

---

[API](https://skmtc.dev/evermind-ai/apis/everos.md) · [All operations](https://skmtc.dev/evermind-ai/apis/everos/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evermind-ai/everos/revisions/9a2e78d664d6/schema)