Send a task to a human for screening and a fixed-price quote

Not binding. A human answers within 24 hours (every day, including weekends and Czech public holidays). Required: description, email and name (the name of the person or company for the invoice); delivery_address is required too when a physical item is to be shipped, handed over or collected. The fields can be sent flat, at the top level (QuoteRequestFlat, the shape smaller models get right), or nested under task / client / agent (QuoteRequestNested); both are accepted, also mixed, and if a field is sent both ways the nested one wins. A missing required field is a 400 that names the field and shows an example. Put everything the user told you (quantity, material, colour, size, address) into the fields or into description. For name use the company or person from the shipping address (or the company the user gave); do not ask the user for it, ask only if there is neither. If the user gave an address, its country is the country (ISO 3166-1 alpha-2). A VAT id only if the user gave one: never guess or make one up. Never invent a quote_id or a status: a real quote_id starts with q_ and comes only from this tool's own response. The answer carries quote_id and access_token: Tell the user to save the access_token now: it is shown once and is the only key to the quote and the task. If the access_token is lost: POST https://api.handsforagents.com/v1/quotes/{quote_id}/access-token (REST only, not a tool); a new one is sent to the contact e-mail. get_status cannot recover it.

post/quotes

Request

  • Base URL: https://api.handsforagents.com/v1
  • URL: https://api.handsforagents.com/v1/quotes
  • Auth: none required

Request body

OR

Response

Request received

quote_idstring required
access_tokenstring required
status'received' required
response_due_atstring date-time required
nda_url'https://handsforagents.com/nda.html' uri required

One-way non-disclosure agreement, pre-filled with the provider's details. Optional: every task is confidential under the terms of service without it. The operator fills in its details, signs and e-mails the PDF to legal@handsforagents.com.

upload_urlstring uri

POST input files here (multipart, field name file) instead of a URL in task.input_files or an e-mail attachment. Same access_token, as a bearer token.

next_actionstring

One or two sentences in English: what to do now (tell the user to save the access_token, when the answer is due, which call to make next).

Changes

No recorded changes to this operation across all 1 revision of this API.