Developers

Translations

Update form translation

put
https://api.typeform.com/forms/{form_id}/translations/{language}

Updates the content of a translation for a given form and language.

Request

Path Parameters

form_id
string

Unique ID for the form. Find in your form URL. For example, in the URL "https://mysite.typeform.com/to/u6nXL7" the form_id is u6nXL7.

language
string
Valid values:arcachcsdadeelenesetfifrhehrhuitjakoltnlnoplptrusvtrukzh

Language code corresponding with the language of the translation. For example, if your language is English, the language code is en.

Request Body

fields Path 3
array of object
attachment Path 3
object
properties Path 3
object, required
description
string, required
id
string, required
layout Path 3
object
attachment Path 3
object, required
properties Path 3
object, required
description
string, required
properties Path 3
object
button_text
string
choices Path 3
array of object
attachment Path 3
object
properties Path 3
object, required
description
string, required
id
string, required
label
string
description
string
fields
array of array
labels Path 3
array of object
center
string
left
string
right
string
title
string
messages Path 3
object

Messages that forms can use.

label.buttonHint.default
string

Default tooltip button message. Maximum 28 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.buttonHint.longtext
string

Tooltip button message for long text blocks. Maximum 28 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.warning.connection
string

Server connection error message. Maximum 128 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.buttonNoAnswer.default
string

Default continue button message. Maximum 100 characters.

label.warning.correction
string

List of errors message. Maximum 128 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.payment.cardNameTitle
string

Credit card name message. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.payment.cardNumberTitle
string

Credit card number message. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.payment.cvcDescription
string

Credit card security number message

block.payment.cvcNumberTitle
string

Credit card CVC number message. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.shortText.placeholder
string

Text input placeholder. Maximum 100 characters.

label.error.emailAddress
string

Invalid email error message. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.error.expiryMonthTitle
string

Credit card expiry month message. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.error.expiryYearTitle
string

Credit card expiry year message. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.warning.fallbackAlert
string

Fallback alert message. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.fileUpload.choose
string

File upload button message. Maximum 34 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.fileUpload.drag
string

File upload dragging action message. Maximum 35 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.fileUpload.uploadingProgress
string

Still processing file upload message. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.error.sizeLimit
string

File too big error message. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.warning.formUnavailable
string

Private form error message. Accepts variable form:name. Maximum 128 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.error.incompleteForm
string

Incomplete fields error message. Maximum 42 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.hint.key
string

Key letter hint message. Maximum 100 characters.

block.legal.reject
string

Legal field deny message. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.legal.accept
string

Legal field accept message. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.error.maxValue
string

Number maximum value tooltip message. Accepts variable field:max. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.error.maxLength
string

Text fields maximum length tooltip message. Accepts variable field:max_length. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.error.minValue
string

Number minimum value tooltip message. Accepts variable field:min. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.error.range
string

Number minimum and maximum range value tooltip message. Accepts variables field:min and field:max. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.multipleChoice.hint
string

Choose as many as you like message for multiple choice fields. Maximum 45 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.error.mustEnter
string

Required value error message. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.error.mustSelect
string

Required selection error message. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.no.shortcut
string

Keyboard shortcut for the "No" option. Maximum 1 character.

label.no.default
string

Representation for the word "No." You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.dropdown.hint
string

Not suggestions found for dropdown fields error message. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.multipleChoice.other
string

Other answer message. Maximum 100 characters.

label.progress.percent
string

Completion percentage message. Accepts variable progress:percent. Maximum 100 characters.

label.progress.proportion
string

Completion proportion message. Accepts variables progress:step and progress:total. Maximum 100 characters.

label.error.required
string

Required field error message. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.preview
string

Review fields error message. Accepts variable form:unanswered_fields. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.button.review
string

Review button message. Maximum 100 characters.

label.error.server
string

Server error message. Maximum 128 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.action.share
string

Share text message. Maximum 100 characters.

label.button.submit
string

Submit button message. Maximum 100 characters.

label.warning.success
string

Successful submit message. Maximum 128 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.button.ok
string

Answer confirm. Maximum 100 characters.

label.error.mustAccept
string

Legal field terms and conditions message. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.longtext.hint
string

Long text field tooltip message. Maximum 128 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

block.dropdown.placeholder
string

Placeholder message with instructions for dropdown fields. Maximum 100 characters.

block.dropdown.placeholderTouch
string

Placeholder message with instructions for dropdown fields on touch devices. Maximum 100 characters.

label.error.url
string

Invalid URL error message. Maximum 64 characters. You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

label.yes.shortcut
string

Keyboard shortcut for the "Yes" option. Maximum 1 character.

label.yes.default
string

Representation for the word "Yes". You can format messages with bold (*bold*) and italic (_italic_) text. HTML tags are forbidden.

thankyou_screens Path 3
array of object
attachment Path 3
object
properties Path 3
object, required
description
string, required
id
string, required
layout Path 3
object
attachment Path 3
object, required
properties Path 3
object, required
description
string, required
properties Path 3
object
button_text
string
description
string
title
string, required
welcome_screens Path 3
array of object
attachment Path 3
object
properties Path 3
object, required
description
string, required
id
string, required
layout Path 3
object
attachment Path 3
object, required
properties Path 3
object, required
description
string, required
properties Path 3
object
button_text
string
description
string
title
string, required

Responses

Status

204 OK

Status

400 Bad request. Check request body for more details

Schema

code
string

A developer-readable snake_case key, indicating some idea of what type of error occurred.

description
string

A developer-readable description of the error, expanding on the terse code.

details Path 3
array of object

An optional object containing more detailed info regarding which field the error occurred in.

code
string

A developer-readable snake_case key, indicating some idea of what type of error occurred.

description
string

A developer-readable description about the field-level error.

field
string

Which field the error occurred. This could refer to a field in the request body, request header, or query parameter.

help
string

A URL linking to help content, to aid the client developer in resolving the error. This value should be provided whenever available.

in
string
Valid values:headerbodyquery

The type of field that caused the error.

help
string

A URL linking to help content, to aid the client developer in resolving the error. This value should be provided whenever available.

Status

404 Form ID not found

Schema

code
string

A developer-readable snake_case key, indicating some idea of what type of error occurred.

description
string

A developer-readable description of the error, expanding on the terse code.

details Path 3
array of object

An optional object containing more detailed info regarding which field the error occurred in.

code
string

A developer-readable snake_case key, indicating some idea of what type of error occurred.

description
string

A developer-readable description about the field-level error.

field
string

Which field the error occurred. This could refer to a field in the request body, request header, or query parameter.

help
string

A URL linking to help content, to aid the client developer in resolving the error. This value should be provided whenever available.

in
string
Valid values:headerbodyquery

The type of field that caused the error.

help
string

A URL linking to help content, to aid the client developer in resolving the error. This value should be provided whenever available.