Skip to main content
GET
/
api
/
policy-optimization
/
online
/
jobs
/
{job_id}
curl -X GET "https://api.usesynth.ai/api/policy-optimization/online/jobs/{job_id}" \
  -H "Authorization: Bearer $SYNTH_API_KEY"
{
  "job_id": "po_abc123",
  "status": "running",
  "best_reward": 0.87,
  "best_candidate": {
    "candidate_id": "candidate_9b12"
  },
  "lever_summary": {
    "prompt_lever_id": "mipro.prompt.sys_abc",
    "candidate_lever_versions": {
      "baseline": 1,
      "candidate_9b12": 4
    },
    "best_candidate_id": "candidate_9b12",
    "selected_candidate_id": "candidate_9b12",
    "baseline_candidate_id": "baseline",
    "lever_count": 4,
    "mutation_count": 3,
    "latest_version": 4
  },
  "lever_versions": {
    "mipro.prompt.sys_abc": 4
  },
  "best_lever_version": 4,
  "sensor_frames": [
    {
      "frame_id": "frame_01hzk...",
      "created_at": "2026-02-12T18:44:00Z",
      "sensor_count": 3,
      "sensor_kinds": ["rollout", "reward", "resource"],
      "trace_ids": ["trace_abc"],
      "lever_versions": {
        "mipro.prompt.sys_abc": 4
      }
    }
  ]
}
Fetch the current status and progress for a policy optimization job. For MIPRO jobs, this response also includes lever/sensor telemetry used by online optimization.
job_id
string
required
Policy optimization job ID.
curl -X GET "https://api.usesynth.ai/api/policy-optimization/online/jobs/{job_id}" \
  -H "Authorization: Bearer $SYNTH_API_KEY"
{
  "job_id": "po_abc123",
  "status": "running",
  "best_reward": 0.87,
  "best_candidate": {
    "candidate_id": "candidate_9b12"
  },
  "lever_summary": {
    "prompt_lever_id": "mipro.prompt.sys_abc",
    "candidate_lever_versions": {
      "baseline": 1,
      "candidate_9b12": 4
    },
    "best_candidate_id": "candidate_9b12",
    "selected_candidate_id": "candidate_9b12",
    "baseline_candidate_id": "baseline",
    "lever_count": 4,
    "mutation_count": 3,
    "latest_version": 4
  },
  "lever_versions": {
    "mipro.prompt.sys_abc": 4
  },
  "best_lever_version": 4,
  "sensor_frames": [
    {
      "frame_id": "frame_01hzk...",
      "created_at": "2026-02-12T18:44:00Z",
      "sensor_count": 3,
      "sensor_kinds": ["rollout", "reward", "resource"],
      "trace_ids": ["trace_abc"],
      "lever_versions": {
        "mipro.prompt.sys_abc": 4
      }
    }
  ]
}

Lever/Sensor Fields

  • lever_summary: high-level prompt lever lineage and candidate/version mapping.
  • lever_versions: resolved lever versions for the selected/best candidate.
  • best_lever_version: scalar best prompt lever version.
  • sensor_frames: sensor frame summaries emitted during optimization.
When available, sensor_frames include reward/rollout/resource timing summaries keyed by lever version.