> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://typeform.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://typeform.ferndocs.com/_mcp/server.

# API Changelog

Stay up to date with the latest changes in Typeform API.

We will post here any new changes and breaking changes in our APIs.

## June 17, 2025

## Translations API documentation amendment for properties.labels field

The field `properties.labels` was documented as an array of objects, but it should be used as a plain object. We apologize for any inconvenience this may have caused.

**Translations API:**

* Document field `properties.labels` as a plain object.

## August 13, 2024

## Breaking change: removal of undocumented settings.capabilities field

Effectively from August 13th 2024 an undocumented field `settings.capabilities` was removed from the form definition. This is result of cleanup work to remove deprecated fields. We apologize for any inconvenience this may have caused given the lack of communication about this change.

**Create API:**

* The field `settings.capabilities` was removed from the form definition.

## July 1, 2024

## Enrichment form setting

Now it's possible to set enrichment setting via API for forms of accounts with access to the responses enrichment feature.

**Create API:**

* Ability to set enrichment setting within a form definition. See [form settings](https://www.typeform.com/developers/create/reference/create-form/) for more details.

## March 7, 2024

## Partial responses release

As a part of releasing partial responses we introduced new functionality to Create and Responses API.

**Create API:**

* Ability to create or update milestones within a form definition. See [form settings](https://www.typeform.com/developers/create/reference/create-form/) for more details.

**Responses API:**

* Ability to fetch partial responses. See the new [response_type](https://www.typeform.com/developers/responses/reference/retrieve-responses/) query param for more details.

## August 8, 2023

## 🐛 Choice id and ref in webhook payload

The webhook payload will now include the `id` and the `ref` of the selected choice in choice questions such as `multiple-choice`, `picture-choice`, `dropdown` or `ranking`.

This will help you identify which choice was selected regardless of its label, which is specially useful when you own many forms with different languages.

## May 25, 2023

## 🐛 Return custom typeform link in form API

A typeform link follows the format `https://domain.typeform.com/to/formId` where `formId` is a unique string of random characters. Typeform links could be customized to remove this random string and be more explicit. Turning `https://jonathan.typeform.com/to/zvlr4L` into `https://jonathan.typeform.com/contact`.

When calling the [Retrieve Form endpoint](https://www.typeform.com/developers/create/reference/retrieve-form/) on a typeform that had a custom link, the API was returning the original link with form id. It now returns the custom link.

## March 23, 2023

## Webhook disabled on 404 response

We decided to disable [webhooks](https://www.typeform.com/developers/webhooks/#delivery-retries) that respond with `404` status code.

## March 8, 2023

## New partial update endpoint for themes

We exposed a new `PATCH` endpoint on our themes API, for safely updating themes with partial payloads.

Partial updates via the existing `PUT` endpoint are now deprecated.

## March 2, 2023

## New file upload endpoints

We exposed two additional endpoints for downloading files uploaded by form respondents, both:

* on a [per-file basis](https://www.typeform.com/developers/responses/reference/get-a-file-from-a-response/)
* and for [downloading the full set](https://www.typeform.com/developers/responses/reference/download-all-files-uploaded-by-respondents-for-a-form/) of respondent-uploaded files for a form.

## February 20, 2023

## Webhook payload changes

### New webhooks fields

We updated our webhooks structure to include the ending reference on both: a new field and the `definition` attribute.

An example of a valid webhook payload can be found [here](https://www.typeform.com/developers/webhooks/example-payload/).

## September 1, 2022

## Default type changes

### Deprecating

We plan to gradually move default type from `form` to `quiz`. As such, we recommend developers implement this change by early December 2022. Valid value types can be found [here](https://typeform.com/developers/create/reference/create-form/#create-form).