API changelog
What changed on /v1, newest first.
Changes to /v1, the SDKs and the MCP server. Within
/v1 changes are additive, as Versioning promises: a new
field, endpoint or event is not a breaking change, so handle values you do not
recognise. CI compares every change to the API against the previous one and
refuses a breaking change that was not meant.
2026-10-27
- Presentation: a form can be shown one question per screen as well as a
chat.
settings.presentationischatorsteps, withtheme.transition,theme.transitionSpeed,settings.steps.autoAdvanceandsettings.steps.letterKeys. See Presentation. - Actions:
continueandbackonPOST /v1/sessions/{id}/actions, for forms shown one question at a time. Aquestionevent may carrycurrent, the answer the question already holds. - Endings carry
imageUrlwhen the author added a picture. - SDK 0.4.0:
sessions.continue()andsessions.back(),questionEvent()to read a question'scurrent, and the presentation fields onPublicFormConfig. The React hook returnscurrent,proceed()andback().
2026-10-05
- Removed: the endpoint that connected Stripe with a pasted restricted
key. Stripe now connects like Razorpay and Cashfree:
POST /v1/payment-accounts/oauth/{provider}/startwithstripeas the provider returns Stripe's consent page, and nobody pastes a key.credentialKindno longer reportsrestricted_key. The SDK'spaymentAccounts.connectStripe()goes with it.
2026-10-02
- Webhooks:
response.answer_recorded,session.startedandform.publishedare sent. They were accepted in a subscription before but never delivered. Each carries adataobject; see the payload. - Exports: asking for
disqualifiedresponses now needs a plan that includes partial responses, the same rule as reading them. - Archive:
DELETE /v1/forms/{id}archives a form for 30 days instead of deleting it.GET /v1/archive/forms,POST /v1/archive/forms/{id}/restoreandDELETE /v1/archive/forms/{id}are new. - Deprecated: the
/v1/chat/sessions/{sid}/…and/v1/forms/{id}/chat/sessionsspellings. They keep working and now answer withDeprecationandLinkheaders; use/v1/sessions/{sid}/…. - Spec: every error response declares the error envelope; the respondent
sign-in routes declare their request bodies; session payments, slow (202)
turns,
pendingPaymentand the form document are fully described. - Scopes: knowledge-base writes were published as
form:readand as open to publishable keys. They have always requiredform:write; the spec now says so. - SDK 0.3.0: types generated from the spec, every endpoint covered, and
verifyWebhookaccepts real deliveries. See its changelog for the breaking changes.
2026-10-01
- No IP address is read, stored or returned.
respondent.ipHashis gone fromPOST /v1/forms/{id}/responsesandPOST /v1/forms/{id}/sessions.
2026-09-30
POST /v1/importturns a public Typeform, Google Forms, Tally, Jotform or Youform form, or any public page, into a form document.GETandPATCH /v1/forms/{id}/settingsread and change settings by key.POST /v1/ai/generate-formsets the settings a prompt asks for and lists them insettings.
2026-09-28
- Respondent email sign-in:
POST /v1/sessions/{sid}/auth/email/startand…/auth/email/verify.
2026-09-26
- Webhooks have a delivery queue with per-endpoint retries:
GET /v1/webhooks/stats,PATCH /v1/webhooks/{id},POST /v1/webhooks/{id}/retry-failed, and astatusfilter on deliveries. - Responses carry
metadata: the channel, device and place each one came from.
2026-09-21
- Every list answers
{ data, has_more, next_cursor }and every error the same envelope. Reading a form that was never published returns its draft.
2026-09-16
- Verified payments on the form owner's own Stripe, Razorpay or Cashfree
account:
/v1/payment-accountsandPOST /v1/sessions/{sid}/payments.
2026-09-09
- Templates, versions, spreadsheet feeds and AI generation reach
/v1.
2026-09-04
- Form create, read, update and publish on
/v1; exports, signed downloads and headless file uploads.