Call Jobs API

from pydantic import BaseModel, Field
from typing import Optional, Literal
from datetime import datetime, date

Objective = Literal["CONFIRM_IE_ATTENDANCE", "RESCHEDULE"]

class CallJobItem(BaseModel):
    external_reference_id: Optional[str] = Field(
        None, min_length=1,
        description="Your row identifier. If provided on any row, must be on every row."
    )
    outbound_phone_number: str = Field(
        ..., description="Valid US number in E.164 or normalizable format."
    )
    objective: Objective = Field(
        ..., description="What the agent should accomplish on the call."
    )
    organization_name: str = Field(
        ..., description="Must be configured for the tenant."
    )
    patient_name: str
    patient_ssn: Optional[str] = Field(
        None, description="Accepts 999-88-7777, 999887777, or no dashes."
    )
    patient_dob: date = Field(..., description="ISO 8601 date (YYYY-MM-DD).")
    patient_phone_number: Optional[str] = Field(
        None, description="Same format as outbound_phone_number."
    )
    date_of_injury: date = Field(..., description="ISO 8601 date (YYYY-MM-DD).")
    expected_appointment_date_time: str = Field(
        ..., description="Naive local datetime (YYYY-MM-DDTHH:MM:SS). No offset or Z suffix."
    )
    service_modality: str
    claim_number: Optional[str] = Field(
        "Not Available", description="Defaults to 'Not Available' if omitted or blank."
    )
    insurer_group_name: str
    body_part: str
    provider_office: str = Field(
        ..., description="Natural key for call entity reuse. Case-sensitive."
    )
    provider_office_address: str = Field(..., description="Free-text address.")
    provider_zip: str = Field(
        ..., pattern=r"^\d{5}$",
        description="5-digit US ZIP. Resolves provider timezone server-side. No ZIP+4."
    )

    notes: Optional[str] = Field(None, description="Free-text notes for the agent.")

class CallJobBatchRequest(BaseModel):
    calls: list[CallJobItem] = Field(..., min_length=1)
    trigger_now: Optional[bool] = Field(
        None, description="Defaults to false. See Scheduling behavior below."
    )

type Objective = "CONFIRM_IE_ATTENDANCE" | "RESCHEDULE";

interface CallJobItem {
  /** Your row identifier. If provided on any row, must be on every row. */
  external_reference_id?: string | null;
  /** Valid US number in E.164 or normalizable format. */
  outbound_phone_number: string;
  /** What the agent should accomplish on the call. */
  objective: Objective;
  /** Must be configured for the tenant. */
  organization_name: string;
  patient_name: string;
  /** Accepts 999-88-7777, 999887777, or no dashes. */
  patient_ssn?: string | null;
  /** ISO 8601 date (YYYY-MM-DD). */
  patient_dob: string;
  /** Same format as outbound_phone_number. */
  patient_phone_number?: string | null;
  /** ISO 8601 date (YYYY-MM-DD). */
  date_of_injury: string;
  /** Naive local datetime (YYYY-MM-DDTHH:MM:SS). No offset or Z suffix. */
  expected_appointment_date_time: string;
  service_modality: string;
  /** Defaults to "Not Available" if omitted or blank. */
  claim_number?: string;
  insurer_group_name: string;
  body_part: string;
  /** Natural key for call entity reuse. Case-sensitive. */
  provider_office: string;
  /** Free-text address. */
  provider_office_address: string;
  /** 5-digit US ZIP. Resolves provider timezone server-side. No ZIP+4. */
  provider_zip: string;

  /** Free-text notes for the agent. */
  notes?: string | null;
}

interface CallJobBatchRequest {
  calls: CallJobItem[];        // Min length: 1
  trigger_now?: boolean;       // Defaults to false. See "Scheduling behavior" below.
}

API_KEY="$API_KEY"
URL="https://stage-agent-api.evergrovelabs.com/scheduler/call-jobs"

curl -X POST "$URL" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "calls": [
      {
        "external_reference_id": "row-001",
        "outbound_phone_number": "+16035550100",
        "objective": "CONFIRM_IE_ATTENDANCE",
        "organization_name": "AcmeNet",
        "patient_name": "Jane Sample",
        "patient_dob": "1980-02-03",
        "patient_ssn": "999-88-7777",
        "patient_phone_number": "+12125550100",
        "date_of_injury": "2026-01-15",
        "expected_appointment_date_time": "2026-08-10T09:00:00",
        "service_modality": "occupational therapy",
        "claim_number": "CLM-789",
        "insurer_group_name": "Acme Insurer Group",
        "body_part": "left shoulder",
        "provider_office": "Concord Orthopaedics",
        "provider_office_address": "1 Pillsbury St, Concord NH 03301",
        "provider_zip": "03301"

      }
    ]
  }'

import os
import requests

url = "https://stage-agent-api.evergrovelabs.com/scheduler/call-jobs"
headers = {
    "Authorization": f"Bearer {os.environ['API_KEY']}",
    "Content-Type": "application/json",
    "Accept": "application/json",
}

payload = {
    "calls": [
        {
            "external_reference_id": "row-001",
            "outbound_phone_number": "+16035550100",
            "objective": "CONFIRM_IE_ATTENDANCE",
            "organization_name": "AcmeNet",
            "patient_name": "Jane Sample",
            "patient_dob": "1980-02-03",
            "patient_ssn": "999-88-7777",
            "patient_phone_number": "+12125550100",
            "date_of_injury": "2026-01-15",
            "expected_appointment_date_time": "2026-08-10T09:00:00",
            "service_modality": "occupational therapy",
            "claim_number": "CLM-789",
            "insurer_group_name": "Acme Insurer Group",
            "body_part": "left shoulder",
            "provider_office": "Concord Orthopaedics",
            "provider_office_address": "1 Pillsbury St, Concord NH 03301",
            "provider_zip": "03301"

        }
    ]
}

response = requests.post(url, json=payload, headers=headers)
response.raise_for_status()
data = response.json()

print(data["call_job_id"])
for sr in data["scheduled_requests"]:
    print(f"{sr['external_reference_id']} -> {sr['status']} ({sr['scheduled_request_id']})")

const API_KEY = process.env.API_KEY!;
const url = "https://stage-agent-api.evergrovelabs.com/scheduler/call-jobs";

const payload = {
  calls: [
    {
      external_reference_id: "row-001",
      outbound_phone_number: "+16035550100",
      objective: "CONFIRM_IE_ATTENDANCE",
      organization_name: "AcmeNet",
      patient_name: "Jane Sample",
      patient_dob: "1980-02-03",
      patient_ssn: "999-88-7777",
      patient_phone_number: "+12125550100",
      date_of_injury: "2026-01-15",
      expected_appointment_date_time: "2026-08-10T09:00:00",
      service_modality: "occupational therapy",
      claim_number: "CLM-789",
      insurer_group_name: "Acme Insurer Group",
      body_part: "left shoulder",
      provider_office: "Concord Orthopaedics",
      provider_office_address: "1 Pillsbury St, Concord NH 03301",
      provider_zip: "03301",

    },
  ],
};

const response = await fetch(url, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    "Content-Type": "application/json",
    Accept: "application/json",
  },
  body: JSON.stringify(payload),
});

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const data = await response.json();
console.log(data.call_job_id);
for (const sr of data.scheduled_requests) {
  console.log(`${sr.external_reference_id} -> ${sr.status} (${sr.scheduled_request_id})`);
}

API_KEY="$API_KEY"
CALL_JOB_ID="f15e9b8c-1a2d-4f3e-9c4b-7e8f1a2b3c4d"
URL="https://stage-agent-api.evergrovelabs.com/scheduler/call-jobs/${CALL_JOB_ID}"

curl -G "$URL" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Accept: application/json" \
  --data-urlencode "include_call_attempts=true"

import os
import requests

call_job_id = "f15e9b8c-1a2d-4f3e-9c4b-7e8f1a2b3c4d"
url = f"https://stage-agent-api.evergrovelabs.com/scheduler/call-jobs/{call_job_id}"
headers = {
    "Authorization": f"Bearer {os.environ['API_KEY']}",
    "Accept": "application/json",
}

response = requests.get(url, headers=headers, params={"include_call_attempts": "true"})
response.raise_for_status()
data = response.json()

for sr in data["scheduled_requests"]:
    print(sr["workflow_status"])
    if sr.get("call_attempts"):
        for attempt in sr["call_attempts"]:
            print(f"Attempt {attempt['attempt_number']}: {attempt['status']}")

const API_KEY = process.env.API_KEY!;
const call_job_id = "f15e9b8c-1a2d-4f3e-9c4b-7e8f1a2b3c4d";
const url = new URL(
  `https://stage-agent-api.evergrovelabs.com/scheduler/call-jobs/${call_job_id}`
);
url.searchParams.set("include_call_attempts", "true");

const response = await fetch(url.toString(), {
  method: "GET",
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    Accept: "application/json",
  },
});

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const data = await response.json();
for (const sr of data.scheduled_requests) {
  console.log(sr.workflow_status);
  if (sr.call_attempts) {
    for (const attempt of sr.call_attempts) {
      console.log(`Attempt ${attempt.attempt_number}: ${attempt.status}`);
    }
  }
}

API_KEY="$API_KEY"
curl -X POST "https://stage-agent-api.evergrovelabs.com/scheduler/call-jobs/query" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "call_job_id": "f15e9b8c-1a2d-4f3e-9c4b-7e8f1a2b3c4d",
    "snapshot_ids": [
      "2c9f0d1e-3b4a-4c5d-9e6f-1a2b3c4d5e6f",
      "7d8e9f0a-1b2c-4d3e-8f9a-0b1c2d3e4f5a"
    ]
  }'

import os
import requests

url = "https://stage-agent-api.evergrovelabs.com/scheduler/call-jobs/query"
headers = {
    "Authorization": f"Bearer {os.environ['API_KEY']}",
    "Content-Type": "application/json",
    "Accept": "application/json",
}
payload = {
    "call_job_id": "f15e9b8c-1a2d-4f3e-9c4b-7e8f1a2b3c4d",
    "snapshot_ids": ["2c9f0d1e-3b4a-4c5d-9e6f-1a2b3c4d5e6f"],
}
response = requests.post(url, json=payload, headers=headers)
response.raise_for_status()
data = response.json()
print(data["scheduled_requests"])
print(data["missing_snapshot_ids"])

const API_KEY = process.env.API_KEY!;
const url = "https://stage-agent-api.evergrovelabs.com/scheduler/call-jobs/query";

const response = await fetch(url, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    "Content-Type": "application/json",
    Accept: "application/json",
  },
  body: JSON.stringify({
    call_job_id: "f15e9b8c-1a2d-4f3e-9c4b-7e8f1a2b3c4d",
    snapshot_ids: ["2c9f0d1e-3b4a-4c5d-9e6f-1a2b3c4d5e6f"],
  }),
});

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const data = await response.json();
console.log(data.scheduled_requests);
console.log(data.missing_snapshot_ids);