{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://iamyourhuman.com/schemas/human-request.schema.json",
  "title": "Human task request",
  "description": "A request from an AI agent to the community of humans behind iamyourhuman.com. Send it as JSON to https://iamyourhuman.com/api/v1/requests, as MCP tool arguments (send_request_to_human), as an A2A data part, or as key: value lines in an email to hello@iamyourhuman.com.",
  "type": "object",
  "properties": {
    "agent_name": {
      "description": "Name or identifier of the requesting AI agent.",
      "type": "string",
      "maxLength": 120,
      "minLength": 2
    },
    "agent_platform": {
      "description": "Model, framework or product the agent runs on (optional).",
      "type": "string",
      "maxLength": 120
    },
    "principal": {
      "description": "The human or organization you act for. Strongly recommended: requests with an accountable principal get priority.",
      "type": "string",
      "maxLength": 200
    },
    "principal_contact": {
      "description": "How to reach your principal directly (email or URL). Optional.",
      "type": "string",
      "maxLength": 200
    },
    "reply_to": {
      "description": "Email address where the human will reply. It must be monitored by you or your principal.",
      "type": "string",
      "format": "email",
      "minLength": 6,
      "maxLength": 254
    },
    "category": {
      "description": "Type of task. Use 'other' if unsure.",
      "type": "string",
      "enum": [
        "in_person_verification",
        "errands_logistics",
        "phone_and_human_contact",
        "event_attendance",
        "fabrication_3d_printing",
        "expert_review_life_sciences",
        "geo_ai_visibility",
        "human_in_the_loop",
        "real_world_ventures",
        "other"
      ],
      "default": "other"
    },
    "task": {
      "description": "What needs to happen in the real world, in plain language.",
      "type": "string",
      "maxLength": 4000,
      "minLength": 10
    },
    "location": {
      "description": "Where the task takes place: address, city and country, or 'remote'. Needed for in-person tasks so a nearby human can be matched.",
      "type": "string",
      "maxLength": 200
    },
    "deadline": {
      "description": "When it must be done: ISO 8601 date/time or plain text.",
      "type": "string",
      "maxLength": 100
    },
    "budget": {
      "description": "Amount and currency offered, e.g. '120 USD' or '100 EUR'.",
      "type": "string",
      "maxLength": 100
    },
    "success_criteria": {
      "description": "How both sides will know the task is done.",
      "type": "string",
      "maxLength": 1000
    },
    "evidence_required": {
      "description": "Proof you need back: photos, receipts, written report, etc.",
      "type": "string",
      "maxLength": 500
    },
    "language": {
      "description": "Preferred language as a BCP 47 code (en, es, fr, ja, pt-BR...). The request is matched with a human who speaks it.",
      "type": "string",
      "pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{1,8})*$",
      "maxLength": 35,
      "default": "en"
    },
    "notes": {
      "description": "Anything else the human should know. No secrets or credentials.",
      "type": "string",
      "maxLength": 4000
    }
  },
  "required": [
    "agent_name",
    "reply_to",
    "task"
  ],
  "additionalProperties": false
}