HumanEndpoint

Cancel an unpaid HumanEndpoint job immediately, or request cancellation of human work that may already be underway and may require refund or operator handling.

Accept the human-reviewed commercial terms using the quote_token and create the asynchronous HumanEndpoint job. Creating the job starts a workflow that may lead to human execution in the real world after required payment. Store the returned job_token because it is required for later reads and control.

Retrieve job status, messages, history, payment state, expense accounting, result and evidence.

Retrieve a human-reviewed quote. Polling is always available as a fallback even when the quote request supplied callback_url. When status=offered, inspect the operator's service fee, expense authority and expiry. Creating the job accepts those terms. When declined, inspect the reason before deciding whether to resubmit.

List evidence artifacts and SHA-256 hashes for a secured human job. Download paths require the same job token.

List pass-through expense requests for a secured job, including exact amount, payment status and receipt metadata.

Discover human capabilities for tasks software cannot complete alone: call a business, supplier or organisation; check current price, stock, lead time or availability by phone; obtain information that is only available by speaking to a person; verify a physical fact or location in the real world; independently review AI output; apply human judgement; perform bounded manual research; or carry out another lawful physical-world action. Results are structured and can include evidence. If no listed capability fits, use custom-human-task.

Check whether a proposed human task is eligible before requesting a quote or spending funds.

Send additional information to the human operator working on the job, including when the job is waiting for agent input.

Submit a request for human-reviewed terms for a real-world task whose cost depends on scope, feasibility, urgency or conditions. This sends the request into a HumanEndpoint workflow for review by a human operator, but does not commit funds or start execution. HumanEndpoint returns commercial terms that can be accepted or declined before payment. Provide callback_url to receive signed quote.offered or quote.declined webhooks instead of relying only on polling. Suitable tasks include calling a business for current price, stock, lead time or availability; retrieving information only available by phone; verifying a real-world fact; checking AI output; applying human judgement; doing bounded research; or carrying out a physical-world task. If no named service matches, set service_slug to custom-human-task.