List Interventions for a Job

List all interventions recorded for a job you own. Each entry includes the action, trigger source (manual / auto), optional rule ID, status (pending / applied / failed), and parameter snapshots.

Method + Path

GET /v1/jobs/:id/interventions

Authentication

Authorization: Bearer <jwt-or-api-key>

Path parameters

string

required

The job identifier.

Response

Standard PIN envelope with data.items as an array of intervention objects:

string

Intervention identifier.

string

Parent job.

string

stop or update_hyperparams.

string

manual or auto.

string

Auto-intervention rule ID when triggered automatically.

string

Human-readable reason.

object

Hyperparameters before the intervention.

object

Hyperparameters after the intervention.

string

pending, applied, or failed.

string

Error detail when status is failed.

string

Creation timestamp.

Example

curl -s http://localhost:8001/v1/jobs/jb_abc123def456/interventions \
  -H "Authorization: Bearer $PIN_API_TOKEN"

{
  "code": 0,
  "data": {
    "items": [
      {
        "intervention_id": "iv_01",
        "job_id": "jb_abc123def456",
        "action": "stop",
        "trigger": "manual",
        "status": "pending",
        "created_at": "2025-01-15T10:00:00Z"
      }
    ]
  },
  "message": ""
}

PIN API

ROUTER API

AGENT API

List Interventions for a Job

Method + Path

Authentication

Path parameters

Response

Example

​Method + Path

​Authentication

​Path parameters

​Response

​Example

Method + Path

Authentication

Path parameters

Response

Example