Human For AI

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['message_id', 'access_token'], 'properties': {'message_id': {'type': 'string', 'description': 'The message id from message_human_operator, e.g. MSG-2026-1A2B3C4D'}, 'access_token': {'type': 'string', 'description': 'The access_token returned once at submission — the only key to the thread.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['task_id'], 'properties': {'task_id': {'type': 'string', 'description': 'Task ID returned by submit_human_task, e.g. HFAI-2026-A1B2C3D4E5F60718'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['message', 'reply_to'], 'properties': {'from': {'type': 'string', 'maxLength': 200, 'description': 'Your agent or system identifier'}, 'message': {'type': 'string', 'maxLength': 5000, 'minLength': 5, 'description': 'The message. Plain language, English.'}, 'subject': {'type': 'string', 'maxLength': 200, 'description': 'Short subject line'}, 'reply_to': {'type': 'string', 'description': 'REQUIRED. Email address for the reply (real, reachable, MX-checked) — or an https webhook URL for a signed push.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['message_id', 'access_token', 'message'], 'properties': {'message': {'type': 'string', 'maxLength': 5000, 'minLength': 2, 'description': 'The follow-up text'}, 'message_id': {'type': 'string', 'description': 'The message id from message_human_operator'}, 'access_token': {'type': 'string', 'description': 'The access_token returned once at submission'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['task_type', 'description'], 'properties': {'deadline': {'type': 'string', 'description': 'ISO 8601 datetime, e.g. 2026-07-10T12:00:00+03:00'}, 'delivery': {'enum': ['email', 'status_poll'], 'type': 'string', 'description': "How the deliverable reaches you. 'email' (default) needs contact_email. 'status_poll' is the no-mailbox path for autonomous agents: the result arrives as text in operator_notes via check_task_status — keep the task_id, it is your only key. Budget: 1 status_poll task per client per day."}, 'requester': {'type': 'string', 'maxLength': 200, 'description': 'Your agent or system identifier, e.g. my-agent/1.0'}, 'task_type': {'enum': ['real_world_verification', 'product_or_app_testing', 'human_judgment_and_feedback', 'data_collection', 'local_physical_task', 'ai_output_review', 'prompt_and_workflow_testing', 'simulation_and_automation_testing', 'accessibility_and_usability_check', 'decision_escalation', 'custom_human_in_the_loop'], 'type': 'string', 'description': 'Service category — see get_human_services for descriptions. The list is not exhaustive: use custom_human_in_the_loop for anything that fits no other category'}, 'description': {'type': 'string', 'maxLength': 5000, 'minLength': 10, 'description': 'What to do, where, and what success looks like. Specific, self-contained tasks are accepted faster.'}, 'contact_email': {'type': 'string', 'description': "Where the deliverable and clarifying questions are sent. Required unless delivery is 'status_poll'. Must be a real, reachable mailbox — placeholder domains are rejected and the domain is MX-checked."}, 'output_format': {'type': 'string', 'description': 'text_report (default), text_report_with_photos, structured_json, annotated_screenshots, or video'}, 'location_detail': {'type': 'string', 'maxLength': 500, 'description': 'City, address, or area — required in practice when location_required is true'}, 'location_required': {'type': 'boolean', 'description': 'true if the task needs physical presence (coverage is confirmed at review)'}}}