tickerbot_update_webhook
Edit a webhook in place — send only the fields you want to change. The trigger and channel are immutable — delete and re-create to change what fires or where it delivers. Unknown fields are a 400.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Webhook id. | |
| name | No | New display name. Non-empty, max 80 characters. | |
| cadence | No | Evaluation cadence. A user preference — never gated. Event triggers deliver on ingest — only `realtime` is accepted on them (400 otherwise). | |
| enabled | No | `false` disables the webhook (status → `disabled`). `true` is a no-op unless disabled, in which case use `POST /v2/webhooks/{id}/enable` instead. | |
| target_url | No | New https:// delivery URL (webhook channel only — a Discord/mobile subscription 400s here). `null` or empty switches to in-app delivery; `status` is untouched — a disabled webhook stays disabled until `POST /v2/webhooks/{id}/enable` (the only path that re-checks your account's webhook cap). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | The stored predicate. Custom signals appear expanded: the SQL is frozen at creation. | |
| id | Yes | The webhook id — `wh_…`, the handle for every other call on this record. | |
| dir | Yes | Sort direction for that list; `null` means the default (`desc`). | |
| name | Yes | Your label for the subscription. | |
| as_of | Yes | Server time this response was assembled (ISO 8601). | |
| order | Yes | Sort signal for the payload row list; `null` means the evaluator default (`market_cap`). | |
| fields | Yes | Extra signals carried on each fired match row; `null` means the standard set. | |
| source | Yes | Which API version created the record; `v2` for anything you create today. | |
| status | Yes | `active` or `disabled`. Auto-disable follows repeated delivery failure. | |
| cadence | Yes | How often the trigger is evaluated — `realtime`, `hourly`, or `nyse_open`. | |
| channel | Yes | Where deliveries go: `webhook`, `discord`, `in_app`, or `mobile_push`. | |
| event_q | No | Event-trigger webhooks only: the payload filter, or `null`. | |
| rule_id | Yes | Legacy link to a v1 alert rule; `null` on everything created through v2. | |
| delivery | Yes | Legacy alias of `channel`, kept aligned for older readers. | |
| created_at | Yes | Creation timestamp. | |
| last_error | No | The last evaluation error; `null` on a healthy hook. The answer to "why is my webhook not firing?". | |
| last_fired | Yes | When a delivery last went out; `null` if it never has. | |
| target_url | Yes | Your HTTPS endpoint; `null` on every channel except `webhook`. | |
| updated_at | Yes | Last modification timestamp. | |
| event_kinds | No | Event-trigger webhooks only: the kinds subscribed (`split`, `dividend`, `insider`, `analyst`, `earnings`). | |
| universe_id | Yes | Universe the trigger is scoped to, or `null` for the whole market. | |
| next_eval_at | Yes | When the evaluator will next consider this subscription. | |
| trigger_kind | No | Event-trigger webhooks only: `event`. | |
| event_tickers | No | Event-trigger webhooks only: the symbols the trigger is scoped to, or `null` for the universe / whole market. | |
| last_match_set | Yes | Tickers matching at the last evaluation — the set the next run is diffed against, which is what makes firing edge-triggered. | |
| last_evaluated_at | Yes | When it was last evaluated; `null` until the first run. | |
| last_eval_error_at | No | When the last evaluation error happened; `null` on a healthy hook. | |
| subscription_origin | Yes | Which door created it — `type` (`ticker`/`signal`/`scan`/`event`), its `ref`, and the `condition` in display form. | |
| last_predicate_value | Yes | The trigger's value at the last evaluation; `null` until it has run. |