Standing Intents (webhook push)
standing_intentRegister a standing query to receive HMAC-signed webhook notifications when new matches appear for deals, news, or permits. No polling—DC Hub pushes updates to your HTTPS endpoint.
Instructions
STANDING QUERIES with webhook push — register an intent once and DC Hub POSTs an HMAC-signed webhook to YOUR https URL whenever matches grow (push, not poll: "notify my orchestrator on any new deal in Columbus"). Requires a key. Params: action ("register" default | "list" | "delete"), kind ("new_deal_in_market" watches deals in params market · "news_keyword" watches news matching q · "permitting_change" watches published permitting intel, optionally per state), market / q / state (the watch parameter for the chosen kind), webhook_url (public HTTPS only — private/internal hosts rejected), intent_id (for delete). Register returns {intent_id, secret} — SAVE the secret: every delivery carries X-DCHub-Signature: sha256=HMAC(secret, body). First evaluation initializes the watermark silently; growth fires the webhook; 5 straight delivery failures auto-disable the intent. Evaluated every ~2h. Try: standing_intent kind=news_keyword q=moratorium webhook_url=https://hooks.example.com/dchub. Do NOT use for one-shot reads (use get_news / list_transactions) or email alerts (use set_market_alert); this is machine-to-machine push.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | For news_keyword: the keyword/phrase to watch in title+summary, e.g. moratorium | |
| kind | No | Watch kind: "new_deal_in_market" | "news_keyword" | "permitting_change" | |
| state | No | For permitting_change: optional US state filter, e.g. MN | |
| action | No | "register" (default), "list" (your intents), or "delete" (needs intent_id) | |
| market | No | For new_deal_in_market: the market/region substring to watch, e.g. columbus | |
| intent_id | No | The intent_id to delete (from register/list) | |
| webhook_url | No | Your public HTTPS webhook endpoint (required for register) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| quota | No | Caller quota state (remaining calls, tier) when available. | |
| _entity | No | Payload class discriminator (e.g. facility|market|iso_grid|queue_results|deal|report|response) — branch on this before parsing the rest. | |
| citation | No | Machine-readable citation: how to attribute DC Hub (dchub.cloud) for this payload. | |
| provenance | No | Collection-level provenance block: {source, method, as_of, verification_counts, cite_url_template, license, cite_as}. Quote the verification level when citing. | |
| _front_door | No | In-band front-door hint (first workflow-entry tool of a session): call plan_query(intent) first for the ordered multi-step plan. | |
| _return_loop | No | Suggested next-session delta call (get_changes since=24h) so you pull only what changed. | |
| site_evaluation_handoff | No | Pre-built follow-up calls (analyze_site / get_water_risk args) when the payload carries coordinates — an array of {tool, parameters, why} entries. |