nora triggers

Manage Trigger blocks — API, webhook, and schedule entries into a Flow.

Triggers are how a Flow starts. Three kinds: api (called from an SDK/CLI), webhook (external HTTP POST), and schedule (cron-based).

Commands

Command	Description
triggers create --kind <k>	Add a Trigger block.
triggers update <trigger-id>	Patch fields (many --set-* flags).
triggers edit <trigger-id>	Open Trigger JSON in $EDITOR.
triggers delete <trigger-id>	Remove Trigger.
triggers secret rotate <trigger-id>	Mint a new webhook/API signing secret.

triggers create

nora triggers create --kind webhook --name "customer-events"

Flags:

• --kind (required) — api / webhook / schedule.
• --name <n> — display name.
• --config <json> — inline config for the specific kind.
• --x <n>, --y <n> — canvas position.

The command prints the created Trigger’s ID (and, for webhook/api, the initial secret — copy it now; it’s shown only once).

triggers update

nora triggers update tr_events \
  --set-kind schedule \
  --set-schedule-mode preset \
  --set-period daily \
  --set-time 09:00 \
  --set-timezone Asia/Seoul

Update flags are large — grouped below.

Update flags — grouped

Identity

• --set-name <n>
• --set-kind api|webhook|schedule
• --set-x <n>, --set-y <n>, --set-width <n>

Schedule config (kind = schedule)

• --set-schedule-mode preset|cron
• --set-cron <expr> — for mode = cron, e.g. "0 9 * * *".
• --set-period daily|weekly|monthly|yearly — for mode = preset.
• --set-time HH:MM — for preset.
• --set-day-of-week 1..7 — for weekly.
• --set-day-of-month 1..31 — for monthly.
• --set-month-of-year 1..12 — for yearly.
• --set-interval <n> — interval count.
• --set-timezone <IANA> — e.g. America/Los_Angeles.
• --set-schedule-input <text> — payload injected per scheduled run.
• --set-schedule-thread-id <id> — for chat Agents, thread to post into.
• --set-schedule-user-id <id> — user attribution.
• --set-schedule-tts true|false — treat as text-to-speech input.

Webhook config (kind = webhook)

• --set-webhook-slug <s> — path suffix (URL becomes .../trigger/webhook/<slug>).
• --set-webhook-input-path <json-path> — extract input from body.
• --set-webhook-image-path <json-path> — extract image data.
• --set-webhook-audio-path <json-path> — extract audio data.
• --set-webhook-auth-kind <k> — none / secret / header.
• --set-webhook-auth-header <name> — header name for header auth.

API config (kind = api)

• --set-api-slug <s> — path suffix.
• --set-api-auth-kind <k> — none / secret / header.
• --set-api-auth-header <name>.

Bulk

• --patch <json> — arbitrary merge.

Config patches deep-merge into the existing config.

triggers edit

nora triggers edit tr_events

Full JSON in $EDITOR. Save to apply.

triggers delete

nora triggers delete tr_events

triggers secret rotate

nora triggers secret rotate tr_events

Mints a new signing secret. Prints the plaintext once — copy it into your caller. The old secret continues to work for 60 minutes so you can update callers without downtime.

Rotate on schedule (quarterly is common), or immediately after suspected leak.

Recipes

Add a daily 9AM Seoul-time schedule

TR=$(nora triggers create --kind schedule --name "daily-9am" | jq -r '.id')

nora triggers update $TR \
  --set-schedule-mode preset \
  --set-period daily \
  --set-time 09:00 \
  --set-timezone Asia/Seoul \
  --set-schedule-input "Daily rollup — summarize yesterday's tickets"

Publish the Flow — the schedule starts firing.

Add a webhook trigger for a CMS

TR=$(nora triggers create --kind webhook --name "cms-hook" | jq -r '.id')

nora triggers update $TR \
  --set-webhook-slug cms \
  --set-webhook-input-path payload.body \
  --set-webhook-auth-kind secret

nora triggers secret rotate $TR  # capture the secret

The webhook URL: https://api.platform.nora.my/trigger/webhook/<flow-slug>/cms. Configure the CMS to POST there with X-Nora-Signature.

Convert a preset schedule to cron

nora triggers update tr_daily \
  --set-schedule-mode cron \
  --set-cron "0 9 * * MON-FRI"    # weekdays 9AM

Cron is more expressive than preset — use for anything beyond daily/weekly/monthly patterns.

Change the input path a webhook extracts

Old CMS shape: { "body": "..." } — path was body.

New shape: { "message": { "body": "..." } }:

nora triggers update tr_cms --set-webhook-input-path message.body

Publish the Flow to make the change live.