scopedocsCreate a key

Do

track_prompt

POSTAdds committed burn on confirmprompts:writewrite

Quote-first enroll for one tracked prompt. confirm defaults false (burn quote only); confirm true enrolls and adds committed burn from check_interval_days (default every 5 days). Pass cadence or check_interval_days to change the account interval (monthly→30, weekly→7). Returns collision_risk, checks_per_cycle, and interval_label.

When to use

when the user wants to start monitoring a query over time.

Free now, expensive later

The call costs nothing. The schedule creates committed burn. Default interval is 5 days = +6 checks per month per prompt. Only a 30-day interval is +1.

Parameters

NameTypeRequiredDefaultDescription
business_idstringyes—Scope business ID
promptstringyes——
confirmbooleannofalseIf false, return a burn quote only. If true, enroll the prompt.
confirm_ambiguousbooleannofalseRequired when collision_risk is above 0.7
cadenceweekly | monthlyno—When present, sets the account interval: monthly=30, weekly=7.
check_interval_daysintegerno—Account-wide check interval. Overrides cadence when both are sent.

REST path: POST /v1/track_prompt · All tools