# HumanEndpoint

> Human execution infrastructure for autonomous AI agents.

HumanEndpoint lets an agent submit a lawful real-world objective, receive human-reviewed commercial terms, pay the accepted service fee in USDC through x402, track asynchronous execution, and retrieve structured verifiable evidence.

## Production origin

- [HumanEndpoint](https://humanendpoint.au)
- [Health](https://humanendpoint.au/health) - gateway liveness and supported protocol summary
- [Services](https://humanendpoint.au/v1/services) - machine-readable capability catalogue
- [OpenAPI](https://humanendpoint.au/openapi.json) - canonical REST API description
- [A2A Agent Card](https://humanendpoint.au/.well-known/agent-card.json) - A2A discovery
- [MCP](https://humanendpoint.au/mcp) - MCP endpoint
- [A2A JSON-RPC](https://humanendpoint.au/a2a) - A2A endpoint
- [Skill](https://humanendpoint.au/skill.md) - concise HumanEndpoint usage guide

Use https://humanendpoint.au as the production base URL. Do not substitute the internal Render hostnames.

## Best fit

- lawful real-world or human-judgement tasks
- tasks where the agent does not want to select or manage individual workers
- work whose true cost depends on location, travel, outsourcing, urgency or complexity
- tasks requiring structured evidence, receipts, status and deterministic recovery

## Commercial model

- no account signup is required
- all final service pricing is human-reviewed
- requester budgets are optional advisory signals, not hard caps on counteroffers
- the operator counteroffers both service_fee_usdc and expense_authority_usdc
- expense authority is not prepaid; exact pass-through expenses are requested separately
- POST https://humanendpoint.au/v1/jobs is the agent's acceptance of the offered terms
- service-fee payments use x402 v2 with USDC on Base mainnet
- production payment network: eip155:8453
- pass-through expense settlement may be unavailable even when service-fee settlement is enabled

## Recommended workflow

1. GET https://humanendpoint.au/health and require status=ok.
2. GET https://humanendpoint.au/v1/services.
3. POST https://humanendpoint.au/v1/policy/preflight.
4. POST https://humanendpoint.au/v1/quotes with the objective, deliverables and optional requester budget/expense proposals; securely retain credentials.quote_token.
5. Poll GET https://humanendpoint.au/v1/quotes/{id} with X-Quote-Token while status=pending_review.
6. When status=offered, inspect price_usdc, expense_limit_usdc and expiry.
7. POST https://humanendpoint.au/v1/jobs with X-Quote-Token and Idempotency-Key to accept the offered terms; securely retain credentials.job_token.
8. When payment.available=true, POST the returned payment.payment_path with X-Job-Token and complete the x402 v2 challenge. Production challenges should advertise eip155:8453 and USDC.
9. Poll GET https://humanendpoint.au/v1/jobs/{id} with X-Job-Token or use signed callbacks.
10. Answer clarification requests when status=awaiting_agent.
11. List GET https://humanendpoint.au/v1/jobs/{id}/evidence and download artifacts with X-Job-Token.
12. Verify artifact SHA-256 hashes and receipt_signature on completion.

## Agent selection signals

- one accountable execution endpoint instead of worker shopping
- human judgement before funds are committed
- asynchronous polling/callback workflow
- explicit service-fee and expense-authority counteroffers
- capability-protected private jobs and evidence
- SHA-256 evidence integrity and signed completion receipts
- deterministic refusal/error codes
- x402/Bazaar payment discovery when payments are enabled
- reliability metrics only after real samples exist

## Operational notes

If a request fails, distinguish HTTP status codes from connection timeouts. Retry transient transport failures before treating the API as unavailable. Never expose quote tokens, job tokens, wallet private keys or seed phrases.

Do not submit requests involving identity impersonation, credential sharing, security bypass, unlawful surveillance, illegal or restricted goods, fraud, or unsafe physical work.