{
  "submit_job_request": {
    "method": "POST",
    "path": "/api/v1/risk/jobs",
    "headers": {
      "Content-Type": "application/json",
      "X-Stella-Tenant": "tenant-default"
    },
    "body": {
      "tenant_id": "tenant-default",
      "context_id": "ctx-001",
      "profile_id": "default-profile",
      "findings": [
        {
          "finding_id": "finding-123",
          "component_purl": "pkg:npm/lodash@4.17.20",
          "advisory_id": "CVE-2024-1234",
          "trigger": "created"
        }
      ],
      "priority": "normal",
      "requested_at": "2025-12-05T00:00:00Z"
    },
    "response": {
      "status": 202,
      "body": {"job_id": "job-001", "status": "queued"}
    }
  },
  "get_job_status": {
    "method": "GET",
    "path": "/api/v1/risk/jobs/job-001",
    "response": {
      "status": 200,
      "body": {
        "job_id": "job-001",
        "status": "completed",
        "results": [
          {
            "finding_id": "finding-123",
            "profile_id": "default-profile",
            "profile_version": "1.0.0",
            "raw_score": 0.75,
            "normalized_score": 0.85,
            "severity": "high",
            "signal_values": {"cvss": 7.5, "kev": true, "reachability": 0.9},
            "signal_contributions": {"cvss": 0.4, "kev": 0.3, "reachability": 0.3},
            "scored_at": "2025-12-05T00:00:02Z"
          }
        ]
      }
    }
  },
  "get_explain": {
    "method": "GET",
    "path": "/api/v1/risk/explain/job-001",
    "response": {
      "status": 200,
      "body_ref": "../explain/explain-trace.json"
    }
  }
}