Settings
Configure form behavior and visibility.
Form Settings
PUT
/api/v1/forms/{id}/settingsRequired scope:write:forms
Request Body (all optional)
| Name | Type | Description |
|---|---|---|
| navigation | vertical | horizontal | Question navigation style |
| display_mode | one_at_a_time | page_by_page | Whether to show one question or one page at a time |
| is_public | boolean | Allow anonymous submissions via a public link |
| public_max_submissions | integer | null | Max anonymous submissions. null = unlimited. |
| language | en | he | auto | Form UI language. auto = detect from browser. |
| quiz_mode | boolean | Enable quiz mode. When true, scores are calculated and shown on the thank-you screen. |
| redirect_url | string | null | Redirect to this URL after submission instead of showing the thank-you screen. |
| max_responses | integer | null | Limit total responses across all recipients. null = unlimited. |
| closes_at | ISO 8601 string | null | Automatically close the form after this date. null = no expiry. |
| embed_allowed_domains | string[] | null | Restrict which domains can embed this form in an iframe. null = allow all. See Embedding Forms guide. |
curl -X PUT https://formalingo.com/api/v1/forms/FORM_ID/settings \
-H "Authorization: Bearer af_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"display_mode": "one_at_a_time",
"language": "en"
}'Example: enable quiz mode
curl -X PUT https://formalingo.com/api/v1/forms/FORM_ID/settings \
-H "Authorization: Bearer af_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"quiz_mode": true
}'Example: set redirect and expiry
curl -X PUT https://formalingo.com/api/v1/forms/FORM_ID/settings \
-H "Authorization: Bearer af_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"redirect_url": "https://example.com/thank-you",
"closes_at": "2026-12-31T23:59:59Z"
}'