API Documentation

# Install the SDK
npm install @humandispatch/sdk

# Or Python
pip install humandispatch

import { HumanDispatch } from "@humandispatch/sdk";

const hd = new HumanDispatch({ apiKey: "sk_live_..." });

// 1. Discover templates
const { templates } = await hd.templates.list();

// 2. Create a task
const task = await hd.tasks.create({
  task_type: "PRODUCT_PHOTO_ECOMM",
  title: "Spring PDP shots — 10 SKUs",
  location: { mode: "onsite", address: "Toronto, ON" },
  schedule: { start_at: "2026-04-22T10:00:00-04:00", duration_hours: 6 },
  budget: { currency: "CAD", pricing_model: "fixed", max_total: 3000 },
  deliverables: [{ kind: "photo", count: 30, format: "jpg" }],
  task_spec: { product_count: 10, background: "white", angles: ["front", "45deg", "detail"] },
});

// 3. Accept work when QA passes
const qa = await hd.workOrders.getQA(workOrderId);
if (qa.qa.overallPass) {
  await hd.workOrders.accept(workOrderId);
}

{
  "mcpServers": {
    "humandispatch": {
      "command": "bun",
      "args": ["run", "src/mcp/server.ts"],
      "env": {
        "HUMANDISPATCH_API_URL": "https://api.humandispatch.io",
        "HUMANDISPATCH_API_KEY": "sk_live_..."
      }
    }
  }
}

{
  "error": {
    "http_status": 400,
    "code": "SCHEMA_VALIDATION_FAILED",
    "message": "Task validation failed",
    "details": { "errors": ["..."] },
    "request_id": "req_01J..."
  }
}