Ask a human
createRequestCollect answers from people outside this chat by link: an open form, survey, poll or sign-up sheet anyone can fill (one link to share anywhere), a form for specific named people (details, intake, availability), or an approval or sign-off from named people (human in the loop). Returns one url (open audience) or one link per named recipient. sendEmail: true emails each named recipient that has an email their link; links[].email is "sent", "failed", "limit", "no address" or "off" for each. Links that were not emailed are in the result for the user to pass on. mode "form" takes a JSON Schema (type object; fields of type string with format email|date|time|date-time|tel|uri|duration, number, integer, boolean, enum, array of primitives; no nested objects (except the location widget), oneOf, anyOf, allOf or $ref; at most 40 fields). Widgets via x-runitby.widget: textarea, radio, select, slider, rating, chips, slots (array of date-time enum), daterange (two dates), location (object, returns latitude/longitude/accuracy), color, country, language, timezone, yesno, rank (array of enum); money is a number with x-runitby.currency; boolean with const true is a required consent box. audience "named" gives each of 1 to 50 people their own link (attributed answers, reminders); "open" gives one link anyone can answer, for surveys, polls and sign-ups, capped by maxSubmissions. mode "approval" takes approval.reason and named recipients, and resolves with a verdict once approval.policy is met; set approval.verify "email" for money, access or deletion. Answers arrive at webhookUrl, by email to your user with notifyEmail, or through getStatus (with wait to block until someone answers); combine them freely. Each call counts as one request against the plan (250 a month on Free); past the limit it fails with a clear error and links already sent keep working.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| theme | No | Colours, font and layout: https://runitby.app/llms.txt ("Theme"). | |
| title | Yes | ||
| locale | No | Language of the hosted page and its emails, optionally with a region for dates, like "es-AR". Write the title and questions in the same language. | |
| schema | No | JSON Schema (type object) for forms. Supported types, formats, widgets and limits: https://runitby.app/llms.txt ("Schema subset"). | |
| approval | No | ||
| audience | Yes | ||
| metadata | No | Returned untouched in every webhook and getStatus. | |
| sections | No | ||
| expiresIn | No | Default 7d, at most 90d. | |
| requester | No | How your agent introduces itself, e.g. "Ava (the Acme refunds agent)". | |
| sendEmail | No | Email each named recipient that has an email their link now. Off by default: then you deliver the links yourself. | |
| webhookUrl | No | ||
| notifyEmail | No | Email the account owner (your user) a summary and a dashboard link: "each" on every answer (until the plan's email limits, then only the end), "complete" once when the request completes or expires. Left out: the account's default from the dashboard ("off" unless changed). |