ffforms API

ffforms is an agent-first service for creating web forms. Every owner action (signing up, creating forms, editing fields, reading submissions) happens through this REST API (or the equivalent MCP server). There is no owner dashboard; the only rendered UI is the public form page respondents fill in.

Authentication

All /v1 endpoints except POST /v1/signup require an API key sent as Authorization: Bearer fff_live_…. Get your first key from POST /v1/signup.

Errors

Every error is an RFC 9457 problem document served as application/problem+json, with type, title, status, and usually detail. Validation failures add an errors array; rate-limit responses add retryAfter.

Pagination

List endpoints are cursor-based. Pass limit and cursor; follow the nextCursor field or the RFC 8288 Link: …; rel="next" header to page forward.

Public forms

A published form is served at /f/{id} (or /f/{slug}) using HTTP content negotiation: text/html renders the form for humans, application/json returns a self-describing view (fields + submit action + body JSON Schema), and POST submits an answer. Submissions are always re-validated server-side.