alerts

Replace the workspace's alert policy (omit a threshold to turn it off)

Set this workspace's two money-safety alerts (a full replace: omitted thresholds turn that alert off). Idle-burn: email (+ optional webhook, + optional auto-stop) when a node bills with every GPU under idle_burn_util_pct% for idle_burn_minutes observed minutes - the watchdog you no longer have to hand-roll, and it cannot die silently because the platform that bills is the platform that watches. Budget: fire once per month when MTD spend crosses budget_warn_pct% of the governing cap.

put/preview/alerts

Request

  • Base URL: https://autoresearch.sfcompute.com
  • URL: https://autoresearch.sfcompute.com/preview/alerts
  • Auth: HTTP bearer

Query parameters

workspacestring

Act in this workspace (its slug). Omitted: the token's bound workspace, then the organization's default. Never ambient - there is no switch-workspace mutation on this door.

Request body

budget_warn_pctinteger nullable

Budget: fire once per month when MTD spend crosses this percent of the workspace (or org) hard cap. Omit to turn it off.

idle_burn_auto_stopboolean nullable

Stop the node automatically when idle-burn fires (the policy-stop path: files intact, next command wakes it). Default false.

idle_burn_minutesinteger nullable

...for this many consecutive observed minutes (>= 5).

idle_burn_util_pctinteger nullable

Idle-burn: fire when every GPU on a billing node stays under this utilization percent... (1-100). Omit to turn idle-burn off.

webhook_urlstring nullable

Optional https webhook POSTed alert JSON alongside the email.

Response

The capability's JSON result.

objectstring

The resource type, when the result is one resource.

Changes

No recorded changes to this operation across all 1 revision of this API.