GET /use-cases/human-in-the-loop-api → 200 OK · task_type: custom_human_in_the_loop

A human-in-the-loop API for AI workflows

Most automation works until it hits a step that needs a person — a judgment call, a physical check, a final sign-off. Human For AI is a human-in-the-loop API: your agent or pipeline sends one JSON request, a real human does the step, and the result comes back in the format you asked for. No SDK, no auth, free during the pilot.

/use-cases/human-in-the-loop-api/examples

When your workflow needs this

pattern/review-gate

Final review gate

Before your agent publishes, sends, or ships something irreversible, route it through a human who approves, flags, or corrects it.

pattern/escalation

Low-confidence escalation

When model confidence drops below your threshold, escalate that single item to a human instead of failing the whole run.

pattern/checkpoint

Recurring human checkpoint

A weekly sanity pass over outputs, listings, or data your automation produces — scoped once via the operator, then repeated.

/protocol

How to submit it

One JSON request — no auth, no SDK. Or connect over MCP and the human becomes a tool: claude mcp add --transport http human-for-ai https://humanforai.dev/mcp. Every task is reviewed by the human operator before acceptance; first response under 12 hours on working days (Sun–Thu). Free during the pilot.

add a human step — POST /api/v1/tasks
curl -X POST https://humanforai.dev/api/v1/tasks \
  -H "Content-Type: application/json" \
  -d '{
    "task_type": "custom_human_in_the_loop",
    "description": "Review the attached summary for factual
                    plausibility and tone before we publish;
                    reply approve/flag with one-line reasons.",
    "output_format": "structured_json",
    "contact_email": "you@example.com",
    "requester": "pipeline/1.0"
  }'
then

Track it

The response returns a task_id and a status URL to poll: submitted → under_review → accepted → in_progress → delivered (or rejected, with a reason). The deliverable also goes to your contact_email.

Full API documentation →

/use-cases/human-in-the-loop-api/faq

Questions agents and builders ask

What is a human-in-the-loop API?

An HTTP interface that lets software hand one step of a workflow to a real person and get the result back programmatically. Here that means POST a task, a verified human operator performs it, and you poll a status URL until the deliverable arrives.

Do I need an account or API key?

No. The API and the MCP server are open during the free pilot — the safety layer is human review of every task before acceptance, not authentication.

How fast is the human?

First response within 12 hours on working days (Sunday–Thursday), typically faster. This is a deliberate trade: real human attention instead of instant automation.

Can the loop be recurring?

Yes — describe the recurring need via message_human_operator (or the contact form) first, agree on scope with the operator, then submit tasks on your schedule.

"task_type": "custom_human_in_the_loop"

Try it with a real task.

Free during the pilot · reviewed before acceptance · evidence included.