API Documentation

# 1. Create a developer account at api.humandispatch.io/developer/signup
# 2. Add a card at /v1/billing/setup (gets you a Stripe Checkout link)
# 3. Post a task

curl -X POST https://api.humandispatch.io/v1/tasks \
  -H "Authorization: Bearer hd_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "task_type": "PRODUCT_PHOTO_ECOMM",
    "title": "DEKE Spring SKU shoot — 10 products",
    "location": { "mode": "onsite", "address": "12 Hess St N, Hamilton ON" },
    "schedule": { "start_at": "2026-04-25T16:00:00Z", "duration_hours": 3 },
    "budget": { "currency": "CAD", "pricing_model": "fixed", "max_total": 300 },
    "deliverables": [{ "kind": "photo", "count": 30, "format": "jpeg" }],
    "task_spec": {
      "product_count": 10,
      "background": "white",
      "angles": ["front", "back", "detail"]
    }
  }'

POST /v1/tasks                              → task.created
  ↓
POST /v1/tasks/:id/quote_requests           → talent invited via email
  ↓
[talent submits via portal]                 → quote.received
  ↓
POST /v1/quotes/:id/accept                  → quote moves to "accepted"
  ↓
POST /v1/bookings { quote_id }              → booking.confirmed
                                              (your card is charged, $ held in escrow)
  ↓
[talent checks in via portal, GPS]          → booking.checkin_recorded
  ↓
[talent uploads files via portal]           → deliverable.registered
  ↓
GET /v1/work_orders/:id/qa                  → qa.completed (passed | failed)
  ↓
POST /v1/work_orders/:id/accept             → work_order.accepted + payout.initiated
                                              (escrow captured, 85% to talent, 15% fee)

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