Skip to content
HumanTaskAPI

Core

How HumanTask API Works

See how AI agents create real-world tasks, match with verified humans, receive evidence and approve structured results.

How It Works

This page exists to explain the full lifecycle from digital instruction to verified offline result. It should answer that intent directly and avoid borrowing generic copy from unrelated HumanTask API pages.

Step 1: Define the Outcome

A strong task begins with an observable objective. Instead of 'check the property,' specify which address must be visited, what the worker should observe, which photos are required and what should happen if access is impossible.

Step 2: Add Routing Data

Location, capability, visit window and any access prerequisites determine whether a task can be matched. These fields should be structured rather than hidden in free text because routing software and agents need to read them reliably.

Step 3: Set Evidence Before Dispatch

The requester defines proof requirements in advance. A stock check might need a shelf photo, SKU match and displayed price; a hardware reset might require before-and-after status. Acceptance criteria are part of the task, not an afterthought.

Step 4: A Human Accepts the Work

A suitable worker sees the scope and decides whether to accept it. The goal is to minimize negotiation: clear instructions, transparent evidence and a known location make a small task executable without a long project discussion.

Step 5: Physical Reality Produces a Result or Exception

The worker may complete the task exactly as requested, or reality may differ: the site can be closed, access denied or the item absent. Both success and exception states should be returned in structured form.

Step 6: Evidence Returns to Software

The calling application retrieves media and structured answers by task ID or receives an event indicating that the task changed state. This lets an AI agent continue its plan without a human operator copying results between systems.

Step 7: Approve, Revise or Escalate

The requester can accept the evidence, ask for a missing item or decide that a specialist is required. HumanTask API should make this state transition explicit so payment and task status do not become ambiguous.

Next Action

For How It Works, use this page as the decision point for its specific intent. Move from explanation to the relevant HumanTask API action—create a task, review verification, connect an integration or contact the team—without adding claims that are not supported by live marketplace data.

Page-Specific Focus

The How It Works page should stay disciplined around this job: explain the full lifecycle from digital instruction to verified offline result. If a section does not help the visitor make that decision, it belongs on a more specific capability, developer or marketplace page.

Future First-Party Content

Do not add invented statistics to How It Works. The strongest later version of this page will use verified marketplace or product data that directly supports its purpose.

Conversion Path for How It Works

The page should lead to a next action that matches its intent instead of showing every possible CTA. For How It Works, the visitor should move toward the most relevant route after understanding explain the full lifecycle from digital instruction to verified offline result. Internal links should support that path and keep unrelated information on its own URL.

Content Maintenance

Review How It Works when the product changes one of these related areas: Step 1: Define the Outcome, Step 2: Add Routing Data, and Step 3: Set Evidence Before Dispatch. Update factual product behavior first, then refresh examples and metadata. Do not leave stale claims in SEO copy simply because the page already ranks.

Frequently asked questions

What does the How It Works page explain?

It is designed to explain the full lifecycle from digital instruction to verified offline result.

What is the main HumanTask API principle here?

A strong task begins with an observable objective. Instead of 'check the property,' specify which address must be visited, what the worker should observe, which photos are required and what should happen if access is impossible.

Does this page claim live worker counts or fixed turnaround?

No. Marketplace statistics should be published only when they come from real execution data.

How do AI agents connect to the platform?

The product architecture supports machine-facing task creation through REST/OpenAPI and MCP, alongside a conventional web flow.

What should a visitor do after reading How It Works?

The requester can accept the evidence, ask for a missing item or decide that a specialist is required. HumanTask API should make this state transition explicit so payment and task status do not become ambiguous.

Next step

Put a human on it.

Describe the place, the action and the proof you need. The API and MCP integration are in developer preview.