Job polling

curl https://api-dev.rcintell.com/v1/agents/jobs/{job_id} \
  -H "X-API-Key: kp_test_..."

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "agent_type": "code_research",
  "result": {
    "codes": [{ "code": "27447", "type": "CPT", "description": "..." }],
    "guidance": "CPT 27447 is the correct code for total knee arthroplasty..."
  },
  "error": null,
  "latency_ms": 3420,
  "created_at": "2026-03-31T10:00:00Z",
  "completed_at": "2026-03-31T10:00:03Z"
}

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "failed",
  "agent_type": "denial_resolution",
  "result": null,
  "error": "Agent dispatch failed",
  "latency_ms": null,
  "created_at": "2026-03-31T10:00:00Z",
  "completed_at": "2026-03-31T10:00:05Z"
}

import time
import httpx

API_KEY = "kp_your_key_here"
BASE = "https://api-dev.rcintell.com"
HEADERS = {"X-API-Key": API_KEY}

# 1. Submit the job
resp = httpx.post(
    f"{BASE}/v1/agents/code-research",
    headers=HEADERS,
    json={"query": "CPT for total knee replacement?", "ccn": "170001"},
)
job_id = resp.json()["job_id"]

# 2. Poll with exponential backoff
delay = 1.0
max_delay = 15.0

while True:
    result = httpx.get(f"{BASE}/v1/agents/jobs/{job_id}", headers=HEADERS)
    data = result.json()

    if data["status"] == "completed":
        print("Result:", data["result"])
        break
    elif data["status"] == "failed":
        print("Error:", data["error"])
        break

    time.sleep(delay)
    delay = min(delay * 2, max_delay)

curl https://api-dev.rcintell.com/v1/agents/jobs/{job_id}/trace \
  -H "X-API-Key: kp_test_..."

{
  "job_id": "550e8400-...",
  "steps": [
    { "type": "reasoning", "content": "Looking up CPT 27447 in MPFS..." },
    { "type": "tool_call", "tool": "knowledge_resolve", "input": { "ccn": "170001", "cpt": "27447" } },
    { "type": "security", "finding": "no_phi_detected", "score": 1.0 }
  ],
  "security_annotations": [
    { "type": "security", "finding": "no_phi_detected", "score": 1.0 }
  ]
}