Hands for Agents

{'type': 'object', 'required': ['task_id', 'accepted', 'access_token'], 'properties': {'reason': {'type': 'string', 'description': 'Required when accepted is false: what differs from the quote.'}, 'task_id': {'type': 'string'}, 'accepted': {'type': 'boolean'}, 'access_token': {'type': 'string', 'description': 'Token returned by request_quote.'}}}

{'type': 'object', 'required': ['quote_id', 'terms_accepted', 'terms_version', 'access_token'], 'properties': {'quote_id': {'type': 'string'}, 'access_token': {'type': 'string', 'description': 'Token returned by request_quote.'}, 'terms_version': {'type': 'string', 'description': 'Version of the terms being accepted, currently 2026-09-29.'}, 'terms_accepted': {'type': 'boolean', 'const': True, 'description': 'Acceptance of https://handsforagents.com/terms.html by the operator.'}, 'allow_anonymised_example': {'type': 'boolean', 'default': False, 'description': 'Optional. Consent to publish this task as an anonymised example (terms, section 10). Only true if the client explicitly agreed. Default false.'}}}

{'type': 'object', 'required': ['id', 'access_token'], 'properties': {'id': {'type': 'string', 'description': 'quote_id or task_id.'}, 'full': {'type': 'boolean', 'default': False, 'description': 'true: the complete answer.'}, 'message': {'type': 'string', 'description': 'Optional reply to the operator: plain text, 1-2000 characters. Leave it out for a plain status check.'}, 'access_token': {'type': 'string', 'description': 'Token returned by request_quote.'}}}

{'type': 'object', 'properties': {'full': {'type': 'boolean', 'default': False, 'description': 'true for the complete document (same as /services.json); false (default) for a short summary.'}}}

{'type': 'object', 'required': ['description', 'email', 'name'], 'properties': {'name': {'type': 'string', 'pattern': '^[^\\r\\n]+$', 'maxLength': 200, 'minLength': 1, 'description': 'Required. The name of the person or company for the invoice.'}, 'email': {'type': 'string', 'format': 'email', 'pattern': '^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$', 'maxLength': 254, 'description': 'Contact e-mail of the operator; the quote goes here.'}, 'vat_id': {'type': 'string', 'maxLength': 32, 'description': 'VAT or tax id for the invoice, only if the user gave it; never guess. Optional.'}, 'country': {'type': 'string', 'pattern': '^[A-Z]{2}$', 'description': "Operator's country, ISO 3166-1 alpha-2, upper case. Optional."}, 'currency': {'enum': ['EUR', 'USD'], 'type': 'string', 'description': 'EUR or USD. Default EUR.'}, 'deadline': {'type': 'string', 'format': 'date', 'maxLength': 32, 'description': 'Latest acceptable delivery date, ISO 8601. Optional.'}, 'services': {'type': 'array', 'items': {'enum': ['design', 'make', 'assemble', 'measure', 'test', 'verify', 'ship'], 'type': 'string'}, 'description': 'Service ids, if you know them.'}, 'agent_name': {'type': 'string', 'maxLength': 200, 'description': 'Name of the agent or platform. Optional.'}, 'description': {'type': 'string', 'maxLength': 20000, 'description': 'What is to be done, plainly: everything the user told you (quantity, material, colour, size, tolerances, what counts as done).'}, 'input_files': {'type': 'array', 'items': {'type': 'string', 'pattern': '^https://', 'maxLength': 2000}, 'maxItems': 20, 'description': 'HTTPS URLs of input files (photos, sketch, STEP/STL model, PDF drawing). At most 20.'}, 'deliverables': {'type': 'string', 'maxLength': 5000, 'description': 'What you expect to receive. Optional; otherwise put it in description.'}, 'delivery_address': {'type': 'string', 'maxLength': 1000, 'description': 'Required for a physical shipment. One plain string: recipient, street, postcode and city, country (only what the user gave; never invent one); a phone number last is optional.'}, 'allow_anonymised_example': {'type': 'boolean', 'default': False, 'description': 'Consent to publish this task as an anonymised example. Only true if the client explicitly agreed. Default false.'}}}