{"uid":"cap_c6j8uyvrUF2FUZu_FjEP-","slug":"munition-form-builder-9fb5ff19","name":"Munition Form Builder","description":"Web search, page reading, PDFs, file sharing, and flight APIs for AI agents. Pay per call in USDC without separate provider API keys.","url":"https://api.munition.io/v1/forms?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"title":{"type":"string","maxLength":120,"minLength":1,"description":"Form title shown to people."},"fields":{"type":"array","items":{"type":"object","required":["id","label","type"],"properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,39}$","description":"Stable key used in answers, unique within the form."},"type":{"enum":["text","long_text","email","number","choice","multi_choice"],"type":"string","description":"text (up to 2000 characters), long_text (up to 5000), email, number, choice (exactly one option) or multi_choice (any number of options)."},"label":{"type":"string","maxLength":200,"minLength":1,"description":"Question text shown to people."},"options":{"type":"array","items":{"type":"string","maxLength":100,"minLength":1},"maxItems":20,"minItems":2,"description":"Required for choice and multi_choice, not allowed otherwise. Unique, ignoring case."},"required":{"type":"boolean","default":false}},"additionalProperties":false},"maxItems":20,"minItems":1,"description":"1 to 20 questions, shown in order."},"closesAt":{"type":"string","format":"date-time","description":"When the form stops accepting answers, with a timezone: between 5 minutes and 30 days from now. Default: 30 days."},"description":{"type":"string","maxLength":1000,"description":"Optional intro under the title. Plain text: newlines are kept, links are not clickable."},"successMessage":{"type":"string","maxLength":300,"description":"Optional message shown after an answer is sent."}}},"responseSchema":{"type":"json","example":{"formId":"frm_AAAAAAAAAAAAAAAAAAAAAA","closesAt":"2026-11-10T00:00:00.000Z","publicUrl":"https://forms.munition.io/f/frm_AAAAAAAAAAAAAAAAAAAAAA","readToken":"frt_example","maxResponses":100,"responsesReadableUntil":"2026-11-17T00:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_IPI8tlP62IcOaa2Bm_-fx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates a hosted web form with custom fields and returns a public URL, read token, and response access details","exampleAgentPrompt":"Create a form titled 'Workshop Feedback' with three questions: a required text field asking 'What was your name?', a required email field asking 'What is your email?', and a required choice field asking 'How would you rate the session?' with options 'Excellent', 'Good', 'Fair', and 'Poor' — make it close in 7 days and show 'Thanks for your feedback!' after submission.","exampleUseCases":[{"title":"Event registration intake form","prompt":"Build a registration form called 'Hackathon Sign-Up 2025' with fields for full name (text, required), email (email, required), and which track they want to join (choice between 'AI', 'Web3', 'Climate Tech', required) — close it in 14 days and say 'You're registered!' after they submit."},{"title":"Customer satisfaction survey","prompt":"Create a satisfaction survey titled 'How did we do?' with a required choice question asking 'How satisfied are you with your experience?' with options 'Very satisfied', 'Satisfied', 'Neutral', 'Dissatisfied', and a long text question asking 'Any other comments?' — close it in 30 days."},{"title":"Job application screening form","prompt":"Make a job application form called 'Frontend Developer Application' with fields for the applicant's full name (text, required), email (email, required), years of experience (number, required), and which frameworks they know (multi_choice with options 'React', 'Vue', 'Angular', 'Svelte') — close it on 2025-09-01T00:00:00Z."}],"resultDescription":"Returns a JSON object containing the unique form ID, a public URL where respondents can fill out the form, a read token to retrieve responses later, the close timestamp, maximum response count, and the deadline until which responses are readable.","failureModes":["Missing required 'title' or 'fields' returns a 400 validation error","Providing 'options' on a non-choice field type returns a 400 error","Omitting 'options' on a 'choice' or 'multi_choice' field returns a 400 error","'closesAt' set fewer than 5 minutes or more than 30 days from now returns a 400 error","More than 20 fields or more than 20 options per field returns a 400 error","Duplicate option values (case-insensitive) within a field return a 400 error","Payment not provided or insufficient USDC results in a 402 Payment Required response","Field 'id' not matching pattern ^[a-z][a-z0-9_]{0,39}$ returns a 400 error"],"whenToPreferThis":"Use this endpoint when an AI agent needs to create a live, hosted web form programmatically and immediately get a shareable public URL — without needing a separate form provider account or API key. It is ideal for agents that need to collect structured input from humans (surveys, registrations, feedback) as part of an automated workflow, paying per form creation in USDC via the x402 protocol.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T00:47:32.874Z","isFirstParty":false,"canonicalSlug":"munition-form-builder-9fb5ff19"}