Developer documentation

Human Task API for AI Agents

Submit reviewed human task requests for AI agents, automation builders, internal tools, and businesses using human-in-the-loop API workflows. This human fallback API supports AI agent task outsourcing, manual task API requests for AI workflows, and real-world task API support for AI agents.

EndpointPOST /api/human-task-request

Requests are reviewed before acceptance. If accepted, DAMG sends a manually generated PayPal payment link before work begins. Results can be returned as email, json, summary, or report.

Human testing

Website, app, checkout, and game testing requests.

Use task_type human_testing when an AI agent or developer needs a real person to test a URL, app flow, checkout/form, or game and return a concise tester report. Include the target URL or download link, platform/device, browser preference, test instructions, stop point, test-only credentials if needed, fake/test data, questions to answer, screenshot or recording preference, maximum test minutes, and contact email. Do not submit real passwords, production secrets, private customer data, payment card numbers, or sensitive personal information.

Prepaid fixed-scope intake

For low-value tasks, agents can submit minimal instructions after prepaid payment.

Use POST /api/prepaid-human-task-intake after paying for a prepaid task on the service page. Required fields are requester_email, payment_method, task_purchased, task_details, success_criteria, and agreement_confirmed. PayPal payments require paypal_transaction_id. Crypto payments require selected_payment_tier, crypto_amount_sent, transaction_hash, payment_reference_id, crypto_asset=USDC, and crypto_network=Base. Optional fields include desired_output_format, result_callback_url, deadline, and additional_context.

Crypto payment option

Human fallback API with USDC payments on Base.

Agents and developers may pay AI agent tasks with crypto by sending USDC on the Base network to 0xE301976Ae257F90ae2254d848AE63D27972C2A35. This is a Coinbase Smart Wallet address that can technically receive funds on multiple compatible EVM networks, but the supported business payment request is USDC on Base unless approved first. A transaction hash and unique payment reference/order ID are required in the prepaid intake request. Crypto payments are manually reviewed, do not guarantee task acceptance, and may be delayed, rejected, or unrecoverable if sent in the wrong asset or on the wrong network.

Request body fields

Send JSON with clear scope and success criteria for human-in-the-loop task fulfillment.

FieldRequiredNotes
requester_emailYesEmail for review, payment link, and delivery.
task_typeYesOne of the supported task types.
task_titleYesShort label for the task.
task_descriptionYesDetailed instructions and constraints.
budget_usdYesProposed budget in USD.
success_criteriaYesDefinition of done.
agreement_confirmedYesMust be true.
requester_nameNoHuman requester name.
company_or_agent_nameNoCompany, system, agent, or workflow name.
locationNoRelevant place, service area, or region.
deadlineNoDate, time window, or urgency.
desired_output_formatNoemail, json, summary, report
additional_contextNoLinks, schema, notes, or special instructions.

Examples

Machine-readable request and response shape for a manual task fulfillment API.

Example JSON request

{
  "requester_name": "Avery Builder",
  "requester_email": "avery@example.com",
  "company_or_agent_name": "Ops Agent Alpha",
  "task_type": "vendor_quote",
  "task_title": "Get three quotes for same-day appliance repair",
  "task_description": "Call vendors in Austin, Texas and request pricing, availability, service area, and appointment requirements.",
  "location": "Austin, TX",
  "deadline": "2026-06-01 5:00 PM CT",
  "budget_usd": 85,
  "desired_output_format": "json",
  "success_criteria": "Return at least three vendors with phone number, quote range, earliest appointment, and notes.",
  "additional_context": "Prefer vendors that answer by phone. Do not book anything without approval.",
  "agreement_confirmed": true
}

Example JSON response

{
  "status": "received",
  "task_id": "human_task_20260523_abc123",
  "message": "Request received for review. If accepted, a PayPal payment link will be sent before work begins."
}

Example crypto prepaid request

{
  "payment_method": "crypto",
  "selected_payment_tier": "$15 Phone Number Verification",
  "crypto_asset": "USDC",
  "crypto_network": "Base",
  "crypto_amount_sent": "15.00",
  "transaction_hash": "0x...",
  "payment_reference_id": "ORDER-123",
  "sender_wallet_address": "0x...",
  "task_purchased": "Phone Number Verification",
  "task_details": "Call the listed business and confirm current monthly pricing.",
  "success_criteria": "Return current price, contact name, and any requirements.",
  "desired_output_format": "json",
  "agreement_confirmed": true
}

Example crypto response

{
  "status": "received",
  "intake_id": "prepaid_task_20260523_abc123",
  "payment_status": "pending_manual_review",
  "message": "Task request and crypto payment details received. Crypto payments are manually reviewed and do not guarantee task acceptance."
}

Task types

Supported task_type values for AI workflow human support.

phone_calllocal_verificationweb_researchvendor_quoteappointment_schedulinghuman_reviewfield_taskdocument_collectionmanual_web_taskhuman_testingcustom_request

Policy and payment

Review-before-payment workflow for human fallback API requests.

Pricing starts with the scope, risk, time, urgency, and complexity of the request. Accepted custom requests receive manual payment instructions. Work begins only after payment is received and reviewed. Agents can use task_type custom_request for complex or unlisted work that needs quote review. Prohibited or unconfirmed requests are rejected. This endpoint is built for reviewed human-in-the-loop operations, not automatic purchasing or unreviewed gig dispatch.

illegal activity

fraud

impersonation

fake reviews

harassment

stalking or surveillance

account abuse

unauthorized access

CAPTCHA bypass as a service

evading security systems

regulated or dangerous purchases

deceptive activity