> ## Documentation Index
> Fetch the complete documentation index at: https://developers.tally.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Changes made to the Tally API worth knowing about

<Info>
  We try to version the API using dates to maintain a highly backwards compatible API. You can
  specify a version using the `tally-version` header, e.g. `tally-version: 2025-02-01`.
</Info>

<Update label="2026-06-23" description="v0.9.0">
  #### New endpoints

  * `GET /workspaces/{workspaceId}/folders`
      <br />
    List a workspace's folders
  * `POST /workspaces/{workspaceId}/folders`
      <br />
    Create a folder
  * `PATCH /workspaces/{workspaceId}/folders/{id}`
      <br />
    Rename a folder
  * `DELETE /workspaces/{workspaceId}/folders/{id}`
      <br />
    Delete a folder and its subfolders, moving any forms they contain to trash

  #### Changed endpoints

  * `GET /workspaces`
      <br />
    Each workspace now includes a `folders` array
  * `GET /workspaces/{workspaceId}`
      <br />
    The response now includes a `folders` array
</Update>

<Update label="2026-06-19" description="v0.8.0">
  #### New endpoints

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

<Update label="2026-06-02" description="v0.7.0">
  #### Changed endpoints

  * `POST /forms`
      <br />
    Form settings accept rich text (`html` with `mentions`) for email and redirect fields
  * `GET /forms/{formId}`
      <br />
    Form settings now return rich text (`html` with `mentions`) for email and redirect fields
  * `PATCH /forms/{formId}`
      <br />
    Form settings accept rich text (`html` with `mentions`) for email and redirect fields
</Update>

<Update label="2026-05-07" description="v0.6.0">
  #### Changed endpoints

  * `GET /forms/{formId}/submissions`
      <br />
    Each submission now includes `previewUrl` and `pdfUrl`
  * `GET /forms/{formId}/submissions/{submissionId}`
      <br />
    The response now includes `previewUrl` and `pdfUrl`
</Update>

<Update label="2026-02-09" description="v0.5.0">
  #### Changed endpoints

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

<Update label="2026-02-05" description="v0.4.0">
  #### 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.
</Update>

<Update label="2025-05-30" description="v0.3.0">
  #### New endpoints

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

  #### Changed endpoints

  * `GET /forms/{formId}/submissions`
      <br />
    Added new filtering options: `startDate`, `endDate` & `afterId`
</Update>

<Update label="2025-02-01" description="v0.2.0">
  #### New endpoints

  * `GET /users/me`

  #### Changed endpoints

  * `GET /forms`
      <br />
    Now returns a paginated response instead of a flat list.
  * `GET /workspaces`
      <br />
    Now returns a paginated response instead of a flat list.

  #### Deprecated endpoints

  * `GET /me`
</Update>

<Update label="2025-01-15" description="v0.1.0">
  Hello world! 🎉
</Update>