Changelog

​

New endpoints

• GET /forms/{formId}/analytics/metrics
  Get aggregate form metrics
• GET /forms/{formId}/analytics/visits
  Get form visits over time
• GET /forms/{formId}/analytics/submissions
  Get completed and partial submissions over time
• GET /forms/{formId}/analytics/dimensions
  Get visitor breakdowns by source, browser, OS, device and location
• GET /forms/{formId}/analytics/drop-off
  Get per-question drop-off statistics

​

Changed endpoints

• POST /forms
  Form settings accept rich text (html with mentions) for email and redirect fields
• GET /forms/{formId}
  Form settings now return rich text (html with mentions) for email and redirect fields
• PATCH /forms/{formId}
  Form settings accept rich text (html with mentions) for email and redirect fields

​

Changed endpoints

• GET /forms/{formId}/submissions
  Each submission now includes previewUrl and pdfUrl
• GET /forms/{formId}/submissions/{submissionId}
  The response now includes previewUrl and pdfUrl

​

Changed endpoints

• GET /forms/{formId}/questions
  Field references (used for default answers and mentions) can now resolve to utility fields, such as utility::today()

​

Breaking changes

• Block payloads are now validated against the schema. Requests with invalid block payload structures will be rejected with a 400 error. Previously, malformed block payloads were accepted silently.

​

New endpoints

• GET /forms/{formId}/questions
  Get form questions
• GET /forms/{formId}/submissions/{submissionId}
  Get a specific form submission
• GET /organizations/{organizationId}/users
  View organization users
• DELETE /organizations/{organizationId}/users/{userId}
  Remove users from organization
• GET /organizations/{organizationId}/invites
  View pending invites
• POST /organizations/{organizationId}/invites
  Invite users to organization
• DELETE /organizations/{organizationId}/invites/{inviteId}
  Cancel pending invites
• GET /webhooks
  List configured webhooks
• GET /webhooks/{webhookId}/events
  List webhook events
• POST /webhooks/{webhookId}/events/{eventId}
  Retry webhook events

​

Changed endpoints

• GET /forms/{formId}/submissions
  Added new filtering options: startDate, endDate & afterId

​

New endpoints

• GET /users/me

​

Changed endpoints

• GET /forms
  Now returns a paginated response instead of a flat list.
• GET /workspaces
  Now returns a paginated response instead of a flat list.

​

Deprecated endpoints

• GET /me