Invoke Human Tool

Forward a handoff you can reassign and invite the new recipients. release defaults to true and drops your own duty to answer down to view. Set release to false to keep that duty. The default is destructive.

Revisions of a handoff this key can see. since_revision returns rows after that number. limit defaults to 50 and maxes at 100. Shared revisions are visible to accepted seats. Per-seat revisions are visible to that seat and the sender. Only-for-me revisions are visible to the seat, and to the sender only when share_with_agent was set on that write.

Read the completed answer for one handoff on this account: PDF paths and recognized handwriting, or JSON answers for an HTML or HUI handoff. If they have not submitted, the result is status pending. Pending is success, not an error. This does not change the handoff.

Read one open or completed handoff this key can see: status, the blocks as stored, answers already on the server, and each section. A section is complete when its logs and required inputs are done. Display blocks do not hold a section open. Pending is a successful read. This does not push and does not change the handoff.

Read one handoff on this account: type, title, and status (new, in_progress, or completed), plus source and file paths. Another account's id is not found. This does not change the handoff.

Fetch one public https URL and store it like upload_image. Private, link-local, and loopback addresses are blocked. Redirects are followed only when the next host is also public https. The type is sniffed and the file must be 2 MB or smaller. Returns image_id, mime, bytes, and sha256. This does not send a handoff.

List the closed ih-ui block catalog. Pass labs true to include labs. names. Props, value shapes, events, merge rules, and examples are in https://invokehumantool.com/skills/invoke-human/references/language.md. This does not create a handoff.

Read completed handoffs on this account after a monotonic revision. Omit since to continue from this key's cursor. The revision increases once per completion. This does not change a handoff.

Create one worksheet, form, approval, review, or sketch for the signed-in person. They write or draw on an Apple device. You get a filled PDF later. This sends something to a person and cannot be silently undone. It does not wait, and sending again creates a second handoff. Pass source so the device can show which session sent it.

Create one HTML handoff the person answers by tapping or typing, on an Apple device or in a browser. Pass html, fields, or both. Scripts are removed. fields are text, choice, checkbox, rating, approval, or file. The result is JSON answers, not handwriting. This sends something to a person and cannot be silently undone. Sending again creates a second handoff. An agent key does not receive answer_url.

Create one HUI 0.1 form or one HUI 1.0 markdown handoff. The person answers with native controls or the signed link. No HTML, CSS, or JavaScript. Call validate_ui first. HUI 0.1 is a JSON document. No HTML, CSS, or JavaScript. kinds: markdown, heading, callout, text, number, choice, multichoice, approval, rating, slider, toggle, date, time, section, group, disclosure, columns. inputs need id matching ^[a-z][a-z0-9_]{0,40}$. visibleIf and requiredIf use == != < > in && || ! plus field ids, strings, numbers, true, false, null, and lists. options may be an array of {value, label} or {"$bind":"/pointer"} into data. Do not send colors, fonts, or pixel sizes. tone is default, accent, or warning. emphasis is true or false. A flat children array is allowed. steps is the other layout, at most 6. Call validate_ui before send_ui_handoff when you are unsure. HUI 1.0 markdown follows https://invokehumantool.com/skills/invoke-human/references/language.md. Call list_blocks for the live catalog. The result is answers keyed by field id, plus summary_text. This sends something to a person and cannot be silently undone. Sending again creates a second handoff. An agent key does not receive answer_url.

Invite more people to a handoff you own. Each recipient is one of user_id, email, handle, group, team, or group_id. They must accept before they can read the pages. This sends an invite and cannot be silently undone. It does not delete the handoff or drop your own duty to answer. Calling it again sends another invite.

Store a PNG, JPEG, or WebP on this account and return its img_ id. Pass data_base64. alt is optional. The type is sniffed from the bytes, not the name. The limit is 2 MB. The same bytes on this account return the same image_id. Reference that id on an image or gallery block, or as . An https or data URL is rejected. This does not send a handoff.

Store an MP4 on this account and return its vid_ id. Pass data_base64. alt is optional. The type is sniffed from the bytes. The limit is 8 MB and 20 seconds. The same bytes on this account return the same video_id. Reference that id on a video block. An https URL is rejected. POST /videos sends those bytes as the raw body, with alt as a query parameter. This does not send a handoff.

Check a form without creating a handoff and without contacting the person. A HUI 0.1 document returns { ok, hui, diagnostics, fields }. HUI 1.0 markdown returns { ok, outcome, hui, registry, blocks, diagnostics } where outcome is valid, violating, or unknown. ok false is a successful tool call so you can correct the document. Interactive blocks are zero tolerance: one error rejects the document. How to read and fix those diagnostics is in https://invokehumantool.com/skills/invoke-human/references/language.md.

Wait up to 50 seconds for one handoff on this account to be submitted. Returns the completed result, or status pending. Pending is success. Call it again to keep waiting. This does not change the handoff. Use it when the client does not declare the MCP Tasks extension. With Tasks, pass mode sync on send instead.