Manually intervene in a running training job

Use this endpoint to manually intervene in a running training job. You can either stop the job immediately or hot-change a subset of hyperparameters (learning rate, epochs, beta, group size) without restarting the container.

Method + Path

POST /v1/jobs/:id/intervene

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).

Request body

string

required

Intervention action. Must be stop or update_hyperparams.

string

Human-readable reason for the intervention (logged for audit).

object

New hyperparameters when action is update_hyperparams. Only these fields may be hot-changed: lr, epochs, beta, group_size.

Request body example

{
  "action": "update_hyperparams",
  "reason": "Reduce LR after spike",
  "hyperparams": {
    "lr": 0.00001,
    "epochs": 5
  }
}

Request example

curl -s -X POST "https://api.ariacompute.com/v1/jobs/jb_abc123def456/intervene" \
  -H "Authorization: Bearer $PIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "update_hyperparams",
    "reason": "Reduce LR after spike",
    "hyperparams": {
      "lr": 0.00001,
      "epochs": 5
    }
  }'

Response

Returns a standard PIN success envelope with the intervention record.

integer

required

0 on success, nonzero on error.

object

required

Show properties

string

The job identifier.

string

The requested action.

string

Intervention status: pending, applied, or failed.

string

Unique identifier for this intervention.

string

Human-readable message (empty on success).

Example response

{
  "code": 0,
  "data": {
    "job_id": "jb_abc123def456",
    "action": "update_hyperparams",
    "status": "pending",
    "intervention_id": "iv_7a8b9c0d1e2f"
  },
  "message": ""
}

Errors

Code	HTTP	Meaning
401	401	Missing or invalid Bearer token.
404	404	Job not found, does not belong to you, or intervention is disabled.
409	409	Job is not running (only running jobs can be intervened).
422	422	Invalid action or hyperparameters contain non-hot-changeable fields.

PIN API

ROUTER API

AGENT API

Manually intervene in a running training job

Method + Path

Authentication

Path parameters

Request body

Request body example

Request example

Response

Example response

Errors

​Method + Path

​Authentication

​Path parameters

​Request body

​Request body example

​Request example

​Response

​Example response

​Errors

Method + Path

Authentication

Path parameters

Request body

Request body example

Request example

Response

Example response

Errors