Agent API guide

find-service.mjs — javascript
// Save as find-service.mjs, then run: node find-service.mjs
const api = "http://localhost:3000/api/v2";
const headers = { Authorization: "Bearer hh_test_demo" };
async function read(path) {
  const response = await fetch(api + path, { headers });
  const body = await response.json();
  if (!response.ok) throw new Error(body.error?.message);
  return body.data;
}
const { providers } = await read(
  "/providers?city=Austin&region=TX&category=personal_care"
);
if (!providers.length) {
  console.log("No published providers match. Discuss alternatives with the user.");
  process.exit(0);
}
// Inspect candidates before choosing: this example only reads details.
const { provider } = await read(
  "/providers/" + encodeURIComponent(providers[0].id)
);
for (const service of provider.services.filter(
  service => service.booking_mode === "appointment"
)) {
  const availability = await read(
    "/providers/" + encodeURIComponent(provider.id) +
    "/availability?service_id=" + encodeURIComponent(service.id)
  );
  console.log({
    name: provider.display_name,
    service,
    qualifications: provider.qualifications,
    notice: provider.qualification_notice,
    availability
  });
}

local-task.mjs — javascript
// Save as local-task.mjs, then run: node local-task.mjs
const at = (minutes) =>
  new Date(Date.now() + minutes * 60_000).toISOString();
const reference = "physical-task-" + crypto.randomUUID();
// Retain this key and the identical body if retrying this request.
​
const response = await fetch("http://localhost:3000/api/v2/tasks", {
  method: "POST",
  headers: {
    Authorization: "Bearer hh_test_demo",
    "Content-Type": "application/json",
    "Idempotency-Key": reference
  },
  body: JSON.stringify({
    category: "physical_task.v1",
    family: "observation",
    title: "Check the park picnic area",
    brief: "Check whether the public picnic tables have shade and wheelchair access.",
    place: {
      name: "Example Park",
      address: "100 Example Street",
      city: "Austin", region: "TX",
      timezone: "America/Chicago"
    },
    requirements: ["Can take clear photos"],
    checklist: ["Check the public approach", "Record shade at each table"],
    evidence: ["photo", "written_report"],
    max_effort_minutes: 20,
    budget: { all_in_max_cents: 2000, currency: "USD" },
    deadlines: {
      bid_by: at(10), dispatch_by: at(20),
      complete_by: at(60), submit_by: at(70), result_by: at(90)
    },
    customer_reference: reference
  })
});
console.log(response.status, await response.json());