{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/needhuman-ai/json-schema/needhuman-ai-patch-api-v1-tasks-taskid-response-schema.json",
  "title": "PatchApiV1TasksTaskidResponse",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_ae-authored/needhuman-ai-openapi-generated.yml#/components/schemas/PatchApiV1TasksTaskidResponse",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "UUID"
    },
    "description": {
      "type": "string",
      "description": "What the human should do"
    },
    "action_type": {
      "type": "string",
      "description": "Category (free‑text)"
    },
    "urgency": {
      "type": "string",
      "description": "\"immediate\" or \"normal\""
    },
    "status": {
      "type": "string",
      "description": "\"pending\", \"in_progress\", \"completed\", \"failed\", or \"expired\""
    },
    "result": {
      "type": "string",
      "description": "What the human did"
    },
    "proof_text": {
      "type": "string",
      "description": "Worker's description of evidence"
    },
    "proof_url": {
      "type": "string",
      "description": "Link to screenshot or proof"
    },
    "proof": {
      "type": "object",
      "description": "Structured proof data"
    },
    "api_key_id": {
      "type": "string",
      "description": "ID of the API key that created this task"
    },
    "source": {
      "type": "string",
      "description": "\"mcp\" if created via NeedHuman MCP server, \"api\" otherwise"
    },
    "idempotency_key": {
      "type": "string",
      "description": "The Idempotency‑Key header value used when creating this task"
    },
    "created_at": {
      "type": "string",
      "description": "\"YYYY-MM-DD HH:MM:SS\""
    },
    "completed_at": {
      "type": "string",
      "description": "Set when status reaches completed or failed"
    }
  }
}