OMomniapp
AI Routines

Run a routine now

Run a routine immediately, in addition to its schedule. The run executes once using the routine owner's permissions and delivers the AI response to every configured recipient — it is not a private preview. A conditional routine evaluates its delivery condition first, so the run may complete without delivering. Because runs execute as the owner, the owner's per-connector AI toggles (set in the chat + menu) govern which integration tools the agent may use. Returns once the run has started; the result is delivered asynchronously. Organization API keys can pass ?userId=<userId> to act on behalf of a specific organization member.

post/api/v1/ai/routines/{id}/trigger

Request

  • Base URL
    https://omniapp.co (the document declares no server; this is the origin it was published from)
  • URL
    https://omniapp.co/api/v1/ai/routines/{id}/trigger
  • Auth
    HTTP bearer

Path parameters

idstring uuid required

The UUID of the routine.

Query parameters

userIdstring uuid

Target user ID (for org-scoped API keys)

Response

The run has started. For a conditional routine this is the condition evaluation, which delivers only if the condition holds.

idstring uuid required

The ID of the run (scheduled job) that was started.

Example response

{
  "id": "990e8400-e29b-41d4-a716-446655440004"
}

Changes

No recorded changes to this operation across all 97 revisions of this API.