Update a scenario
PATCH/watch/scenarios/:scenario_id
Change a scenario. Send only the fields to change; an explicit null clears a nullable field (active_hours → any time, usdt_low_threshold → off, notify_destination_ids → every channel). Changes apply to all of the scenario's addresses right away.
Changing action:
- moving away from
add_on_depositdrops the threshold; moving to it without one sets"100"; - moving to an Energy action turns
energy_alertson; moving toalert_onlyturns it off unless you send"energy_alerts": true; - open deposits close, incoming USDT counts toward the threshold from zero again, and waiting Energy additions are cancelled;
- when the addresses move between the
watch_onlyandwith_energylimits, all of them must fit (409 radar_limit_exceeded).
Switching energy_preset away from custom drops energy_custom.
Request
Responses
- 200
- 401
- 403
- 404
- 409
- 422
- 429
Successful Response
The X-API-Key header is missing, invalid or revoked. detail is a plain string: API key required, Invalid API key or User not found.
radar_access_required: the account has neither a Google sign-in nor 1 TRX of net confirmed deposits; required_deposit_sun and allowed_auth_methods say what unlocks it. The API-wide refusals also apply: a blocked account (plain-string detail) and ip_not_allowed.
radar_disabled, scenario_not_found. radar_disabled: TRONAgg Radar isn't available for this account.
scenario_name_taken; radar_limit_exceeded when a new action moves the addresses to a limit without room for all of them (kind, used, max).
Input Radar can't accept, with field naming it: invalid_name, invalid_action, invalid_threshold, invalid_energy_preset, invalid_energy (custom Energy outside energy_min…energy_max), invalid_times_per_address_day, invalid_daily_budget (outside min_sun…max_sun), invalid_energy_alerts, invalid_active_hours, invalid_usdt_low_threshold, invalid_destinations (unknown lists channel ids that aren't yours). A body or parameter of the wrong type, or an unknown body field, returns FastAPI's detail array instead.
Rate limit exceeded: more than 1,000 requests per minute for your account (shared by all of its API keys and workspace sessions). detail is a plain string; wait the number of seconds in Retry-After, then retry.
Response Headers
Seconds until the rate-limit window resets.