Configure automatic intervention guardrails for training jobs

Automatic intervention lets you define guardrails that fire when training metrics deviate from baselines. You can configure rules for reward spikes, KL divergence explosions, response length surges, and repetition increases. Only running jobs can have their auto-intervention config updated.

Method + Path

GET /v1/jobs/:id/auto-intervention
PUT /v1/jobs/:id/auto-intervention

Authentication

Include your PIN API token or JWT in the Authorization header as a Bearer token.

Authorization: Bearer <token>

Path parameters

string

required

The job identifier (e.g., jb_abc123def456).

GET response

Returns the current auto-intervention configuration for the job inside the standard PIN envelope.

integer

required

0 on success, nonzero on error.

object

required

Show properties

boolean

Whether auto-intervention is active.

array

List of rules.

Show rule object

string

Unique rule identifier.

string

Metric to watch: reward, kl, response_len, repeat.

string

Condition type: spike, drop, kl_explode, len_surge, repeat_up.

integer

Long-term window size in steps (10 to 100000).

number

Ratio threshold for triggering (must be greater than 0).

integer

Consecutive hits required before firing (1 to window_steps).

string

Action to take: stop or update_hyperparams.

object

New hyperparameters when action is update_hyperparams.

integer

Cooldown between repeated triggers of the same rule.

Example GET response

{
  "code": 0,
  "data": {
    "enabled": true,
    "rules": [
      {
        "id": "reward_spike",
        "metric": "reward",
        "condition": "spike",
        "window_steps": 100,
        "threshold": 2.0,
        "min_consecutive": 3,
        "action": "stop"
      }
    ],
    "cooldown_seconds": 300
  },
  "message": ""
}

PUT request body

boolean

required

Turn auto-intervention on or off.

array

required

List of rule objects (see schema above).

integer

required

Minimum seconds between repeated triggers for the same rule (must not be negative).

Request body example

{
  "enabled": true,
  "rules": [
    {
      "id": "reward_spike",
      "metric": "reward",
      "condition": "spike",
      "window_steps": 100,
      "threshold": 2.0,
      "min_consecutive": 3,
      "action": "stop"
    },
    {
      "id": "kl_explode",
      "metric": "kl",
      "condition": "kl_explode",
      "window_steps": 50,
      "threshold": 3.0,
      "min_consecutive": 2,
      "action": "update_hyperparams",
      "hyperparams": {
        "lr": 0.000005,
        "group_size": 2
      }
    }
  ],
  "cooldown_seconds": 300
}

PUT request example

curl -s -X PUT "https://api.ariacompute.com/v1/jobs/jb_abc123def456/auto-intervention" \
  -H "Authorization: Bearer $PIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "rules": [
      {
        "id": "reward_spike",
        "metric": "reward",
        "condition": "spike",
        "window_steps": 100,
        "threshold": 2.0,
        "min_consecutive": 3,
        "action": "stop"
      }
    ],
    "cooldown_seconds": 300
  }'

PUT response

Returns the updated configuration inside the standard PIN envelope.

integer

required

0 on success, nonzero on error.

object

required

Show properties

string

The job identifier.

object

The updated configuration.

Example PUT response

{
  "code": 0,
  "data": {
    "job_id": "jb_abc123def456",
    "auto_intervention": {
      "enabled": true,
      "rules": [
        {
          "id": "reward_spike",
          "metric": "reward",
          "condition": "spike",
          "window_steps": 100,
          "threshold": 2.0,
          "min_consecutive": 3,
          "action": "stop"
        }
      ],
      "cooldown_seconds": 300
    }
  },
  "message": ""
}

Errors

Code	HTTP	Meaning
401	401	Missing or invalid Bearer token.
404	404	Job not found, does not belong to you, or auto-intervention is disabled globally.
409	409	Job is not running (only running jobs can be updated).
422	422	Invalid rule configuration (duplicate IDs, invalid metric/condition/action, out-of-range values).

PIN API

ROUTER API

AGENT API

Configure automatic intervention guardrails for training jobs

Method + Path

Authentication

Path parameters

GET response

Example GET response

PUT request body

Request body example

PUT request example

PUT response

Example PUT response

Errors

​Method + Path

​Authentication

​Path parameters

​GET response

​Example GET response

​PUT request body

​Request body example

​PUT request example

​PUT response

​Example PUT response

​Errors

Method + Path

Authentication

Path parameters

GET response

Example GET response

PUT request body

Request body example

PUT request example

PUT response

Example PUT response

Errors