更新场景

PATCH 
/watch/scenarios/:scenario_id

修改一个场景。只发送要更改的字段；显式的 null 会清除可为空的字段（active_hours → 任何时间，usdt_low_threshold → 关闭，notify_destination_ids → 所有渠道）。更改会立即应用到该场景的所有地址。

更改 action 时：

• 从 add_on_deposit 改为其他操作会丢弃阈值；改为 add_on_deposit 且未提供阈值时设为 "100"；
• 改为能量类操作会开启 energy_alerts；改为 alert_only 会关闭它，除非你发送 "energy_alerts": true；
• 未完成的入账会关闭，转入的 USDT 重新从零开始计入阈值，等待中的能量添加会被取消；
• 当地址在 watch_only 和 with_energy 两个上限之间移动时，必须能容纳全部地址（409 radar_limit_exceeded）。

将 energy_preset 从 custom 改为其他值会丢弃 energy_custom。

请求

Responses

200

成功响应

401

X-API-Key 请求头缺失、无效或已撤销。detail 为纯字符串：API key required、Invalid API key 或 User not found。

403

radar_access_required：该账户既没有 Google 登录，也没有 1 TRX 的已确认净充值；required_deposit_sun 和 allowed_auth_methods 说明如何解锁。API 通用的拒绝同样适用：账户已被封禁（纯字符串 detail）以及 ip_not_allowed。

404

radar_disabled、scenario_not_found。radar_disabled：此账户无法使用 TRONAgg Radar。

409

scenario_name_taken；当新操作把地址移到一个容纳不下全部地址的上限时返回 radar_limit_exceeded（kind、used、max）。

422

Radar 无法接受的输入，由 field 指明是哪一项：invalid_name、invalid_action、invalid_threshold、invalid_energy_preset、invalid_energy（自定义能量超出 energy_min…energy_max）、invalid_times_per_address_day、invalid_daily_budget（超出 min_sun…max_sun）、invalid_energy_alerts、invalid_active_hours、invalid_usdt_low_threshold、invalid_destinations（unknown 列出不属于你的渠道 ID）。请求体或参数类型错误，或请求体中有未知字段时，则返回 FastAPI 的 detail 数组。

429

Rate limit exceeded：你的账户每分钟请求超过 1,000 次（由该账户的所有 API 密钥与工作台会话共用）。detail 为纯字符串；等待 Retry-After 给出的秒数后再重试。

Response Headers

Retry-After

距离限流窗口重置的秒数。