Inne typy
API form monday.com umożliwia pobieranie konfiguracji formularza, jego wyglądu i działania. Pozwala programowo uzyskać dostęp do ustawień, takich jak dostępność, style wizualne, funkcje, pytania i tagi.
Każdy z opisanych poniżej typów obiektów reprezentuje określony aspekt formularza. Można pobierać je jako pola podrzędne zapytania form lub używać do przekazywania metadanych formularza w mutacjach.
CreateFormTagInput
Obiekt zawierający właściwości tagu formularza.
❗️ Zmiana powodująca niezgodność wsteczną w wersji
2026-10Pole
valuew typieCreateFormTagInputzostało usunięte w wersji API2026-10. Przed przejściem na wersję2026-10usuń polevalueze wszystkich wywołańcreate_form_tag.
| Field | Type | Description |
|---|---|---|
| name | String! |
Nazwa tagu. |
CreateQuestionInput
Obiekt zawierający właściwości pytania w formularzu.
| Pole | Opis | Obsługiwane pola |
|---|---|---|
description String |
Opis pytania. | |
options [QuestionOptionInput!] |
label String! |
|
required Boolean |
Określa, czy odpowiedź na pytanie jest wymagana do wysłania formularza. | |
settings FormQuestionSettingsInput |
Ustawienia właściwe dla typu pytania. | checkedByDefault BooleandefaultCurrentDate Booleandisplay FormQuestionSelectDisplayincludeTime BooleanlocationAutofilled BooleanoptionsOrder FormQuestionSelectOrderByOptionsprefill PrefillSettingsInputprefixAutofilled BooleanprefixPredefined PhonePrefixPredefinedInputskipValidation Boolean |
title String! |
Tytuł pytania. | |
type FormQuestionType! |
Typ pytania. Określa sposób wprowadzania danych i ich walidację. | |
visible Boolean |
Określa, czy pytanie jest widoczne dla respondentów. Ukryte pytania pozostają w strukturze formularza, ale nie są wyświetlane respondentom. Wartością domyślną jest true. |
|
show_if_rules JSON |
Reguły logiki warunkowej określające, czy pytanie jest wyświetlane na podstawie odpowiedzi na inne pytania. Dostępne tylko w wersji 2026-07 i nowszych. |
|
existing_column_id String |
Identyfikator istniejącej kolumny tablicy, z którą ma być powiązane to pytanie. Dostępne tylko w wersji 2026-07 i nowszych. |
|
insert_after_question_id String |
Identyfikator pytania, po którym ma zostać dodane nowe pytanie. Dostępne tylko w wersji 2026-07 i nowszych. |
|
page_block_id String |
Identyfikator bloku strony, do którego należy to pytanie. Dotyczy tylko pytań typu PAGE_BLOCK. Dostępne tylko w wersji 2026-07 i nowszych. |
QuestionOptionInput
Tablica obiektów definiujących etykiety opcji w pytaniach wyboru.
| Pole | Opis |
|---|---|
label String! |
Etykieta wyświetlana przy danej opcji. |
value String |
Wewnętrzna wartość opcji. Dostępne tylko w wersji 2026-07 i nowszych. |
visible Boolean |
Określa, czy opcja jest widoczna dla respondentów. Dostępne tylko w wersji 2026-07 i nowszych. |
DehydratedFormResponse
Obiekt zawierający wynik utworzenia nowego formularza za pomocą API.
| Pole | Opis |
|---|---|
boardId ID! |
Unikatowy identyfikator tablicy połączonej z formularzem. |
token String! |
Unikatowy identyfikator formularza. |
DeleteFormTagInput
Definiuje opcje usuwania tagu z formularza za pomocą API.
| Pole | Opis |
|---|---|
deleteAssociatedColumn Boolean |
Określa, czy powiązana kolumna ma zostać usunięta. |
FormAccessibility
Obiekt zawierający ustawienia dostępności formularza.
| Pole | Opis |
|---|---|
language String |
Kod języka określający lokalizację formularza i tekst interfejsu (np. „es”, „en”, „fr”). |
logoAltText String |
Tekst alternatywny opisujący logo formularza. |
FormAppearance
Obiekt zawierający ogólny wygląd formularza (np. tło, układ, kolory i typografię).
| Pole | Opis | Obsługiwane pola |
|---|---|---|
background FormBackground |
Obiekt zawierający konfigurację tła formularza. | type FormBackgroundsvalue String |
hideBranding Boolean! |
Określa, czy branding monday.com jest ukryty. | |
layout FormLayout |
Obiekt zawierający ustawienia struktury i prezentacji formularza. | alignment FormAlignmentdirection FormDirectionformat FormFormat |
logo FormLogo |
Obiekt zawierający ustawienia wyświetlania logo formularza. | position FormLogoPositionsize FormLogoSizeurl String |
primaryColor String |
Kod koloru HEX głównego koloru motywu używanego w formularzu. | |
showProgressBar Boolean! |
Określa, czy wyświetlany jest wskaźnik postępu wypełniania formularza. | |
submitButton FormSubmitButton |
Obiekt zawierający konfigurację przycisku wysyłania formularza. | text String |
text FormText |
Obiekt zawierający ustawienia typografii i stylów tekstu formularza. | color Stringfont Stringsize FormFontSize |
FormBackground
Konfiguruje tło formularza (np. kolor, obraz lub jego brak).
| Pole | Opis | Wartości typu enum |
|---|---|---|
type FormBackgrounds |
Typ tła formularza. | ColorImageNone |
value String |
Wartość tła formularza.
|
FormLayout
Definiuje układ, wyrównanie i format formularza.
❗️ Zmiana powodująca niezgodność wsteczną w wersji
2026-10Pole
formati typ enumFormFormatzostały usunięte w wersji API2026-10. Przed przejściem na wersję2026-10usuń odwołania doformatiFormFormat.
| Pole | Opis | Wartości typu enum |
|---|---|---|
alignment FormAlignment |
Wyrównanie tekstu i zawartości formularza. | CenterFullLeftFullRightLeftRight |
direction FormDirection |
Kierunek czytania formularza. | LtRRtl |
FormLogo
Konfiguruje logo formularza (np. jego położenie, rozmiar i adres URL obrazu).
| Pole | Opis | Wartości typu enum |
|---|---|---|
position FormLogoPosition |
Położenie logo formularza. | AutoCenterLeftRight |
size FormLogoSize |
Rozmiar logo formularza. | ExtraLarge (wysokość 96px)Large (wysokość 72px)Medium (wysokość 40px)Small (wysokość 32px) |
url String |
Adres URL logo formularza. |
FormSubmitButton
Definiuje tekst przycisku wysyłania formularza.
| Pole | Opis |
|---|---|
text String |
Niestandardowy tekst wyświetlany na przycisku wysyłania formularza. |
FormText
Definiuje konfigurację typografii formularza.
| Pole | Opis | Wartości typu enum |
|---|---|---|
color String |
Kod koloru HEX tekstu formularza. | |
font String |
Krój pisma używany w formularzu. | |
size FormFontSize |
Podstawowy rozmiar tekstu formularza. | LargeMediumSmall |
FormFeatures
Obiekt zawierający funkcje dostępne na poziomie formularza, takie jak wymóg logowania, limity odpowiedzi i ochrona hasłem.
| Pole | Opis | Obsługiwane pola |
|---|---|---|
afterSubmissionView FormAfterSubmissionView |
Obiekt zawierający konfigurację formularza po jego wysłaniu. | allowEditSubmission Boolean!allowResubmit Boolean!allowViewSubmission Boolean!description StringredirectAfterSubmission FormRedirectAfterSubmissionshowSuccessImage Boolean!title String |
closeDate FormCloseDate |
Obiekt zawierający konfigurację automatycznego zamknięcia formularza. | date Stringenabled Boolean! |
draftSubmission FormDraftSubmission |
Obiekt zawierający konfigurację zapisywania wersji roboczych formularza. | enabled Boolean! |
isInternal Boolean! |
Określa, czy formularz jest dostępny wyłącznie dla użytkowników wewnętrznych. | |
monday FormMonday |
Obiekt zawierający ustawienia tablicy dotyczące obsługi odpowiedzi. | includeNameQuestion Boolean!includeUpdateQuestion Boolean!itemGroupId StringsyncQuestionAndColumnsTitles Boolean! |
password FormPassword |
Obiekt zawierający konfigurację ochrony formularza hasłem. | enabled Boolean! |
preSubmissionView FormPreSubmissionView |
Obiekt zawierający konfigurację ekranu powitalnego. | description Stringenabled Boolean!startButton FormStartButtontitle String |
reCaptchaChallenge Boolean! |
Określa, czy w formularzu włączono weryfikację reCAPTCHA, aby zapobiec wysyłaniu spamu. | |
requireLogin FormRequireLogin |
Obiekt zawierający ustawienia wymogu logowania do formularza. | enabled Boolean!redirectToLogin Boolean! |
responseLimit FormResponseLimit |
Obiekt zawierający ustawienia limitu odpowiedzi. | enabled Boolean!limit Int |
shortenedLink FormShortenedLink |
Obiekt zawierający konfigurację skróconego adresu URL formularza. | enabled Boolean!url String |
FormAfterSubmissionView
Obiekt zawierający ustawienia formularza po jego wysłaniu.
| Pole | Opis | Obsługiwane pola |
|---|---|---|
allowEditSubmission Boolean! |
Określa, czy użytkownicy mogą edytować swoje odpowiedzi po wysłaniu formularza. | |
allowResubmit Boolean! |
Określa, czy użytkownicy mogą wielokrotnie wysyłać odpowiedzi w tym samym formularzu. | |
allowViewSubmission Boolean! |
Określa, czy użytkownicy mogą wyświetlić swoje odpowiedzi po wysłaniu formularza. | |
description String |
Tekst wyświetlany po wysłaniu formularza. | |
redirectAfterSubmission FormRedirectAfterSubmission |
Obiekt zawierający konfigurację przekierowania po wysłaniu formularza. | enabled Boolean!redirectUrl String |
showSuccessImage Boolean! |
Określa, czy po wysłaniu formularza wyświetlany jest obraz potwierdzający powodzenie. | |
title String |
Tytuł wyświetlany po wysłaniu formularza. |
FormRedirectAfterSubmission
Obiekt zawierający konfigurację przekierowania po wysłaniu formularza.
| Pole | Opis |
|---|---|
enabled Boolean! |
Określa, czy po wypełnieniu formularza respondenci są automatycznie przekierowywani pod wskazany adres URL. |
redirectUrl String |
Adres URL, pod który użytkownicy są przekierowywani po pomyślnym wypełnieniu formularza. |
FormCloseDate
Obiekt zawierający konfigurację automatycznego zamknięcia formularza.
| Pole | Opis |
|---|---|
date String |
Znacznik czasu ISO 8601 określający, kiedy formularz automatycznie przestanie przyjmować odpowiedzi. |
enabled Boolean! |
Określa, czy formularz jest automatycznie zamykany w określonym dniu i o określonej godzinie. |
FormDraftSubmission
Obiekt zawierający konfigurację zapisywania wersji roboczych formularza.
| Pole | Opis |
|---|---|
enabled Boolean! |
Określa, czy użytkownicy mogą zapisywać nieukończone odpowiedzi jako wersje robocze. |
FormMonday
Obiekt zawierający ustawienia tablicy dotyczące obsługi odpowiedzi w formularzu.
| Pole | Opis |
|---|---|
includeNameQuestion Boolean! |
Określa, czy do formularza dodawane jest pytanie o imię i nazwisko. Odpowiada ono kolumnie nazwy elementu na tablicy. |
includeUpdateQuestion Boolean! |
Określa, czy do formularza dodawane jest pole aktualizacji. Odpowiada ono sekcji aktualizacji powiązanego elementu. |
itemGroupId String |
Identyfikator grupy na tablicy, w której na podstawie odpowiedzi z formularza zostaną utworzone nowe elementy. |
syncQuestionAndColumnsTitles Boolean! |
Określa, czy tytuł pytania w formularzu jest synchronizowany z nazwą kolumny na tablicy. |
FormPassword
Obiekt zawierający konfigurację ochrony formularza hasłem.
| Pole | Opis |
|---|---|
enabled Boolean! |
Określa, czy użytkownicy muszą podać hasło, aby uzyskać dostęp do formularza. |
FormPreSubmissionView
Obiekt zawierający ustawienia opcjonalnego ekranu powitalnego wyświetlanego przed rozpoczęciem formularza.
| Pole | Opis | Obsługiwane pola |
|---|---|---|
description String |
Tekst wyświetlany na ekranie powitalnym (np. dodatkowe informacje lub instrukcje). | |
enabled Boolean! |
Określa, czy przed rozpoczęciem formularza wyświetlany jest ekran powitalny. | |
startButton FormStartButton |
Obiekt zawierający konfigurację przycisku rozpoczęcia na ekranie powitalnym formularza. | text String |
title String |
Tytuł wyświetlany na ekranie powitalnym. |
FormRequireLogin
Obiekt zawierający ustawienia wymogu logowania do formularza.
| Pole | Opis |
|---|---|
enabled Boolean! |
Określa, czy użytkownicy muszą się zalogować przed wysłaniem odpowiedzi. |
redirectToLogin Boolean! |
Określa, czy nieuwierzytelnieni użytkownicy są automatycznie przekierowywani na stronę logowania. |
FormResponseLimit
Obiekt zawierający ustawienia limitu odpowiedzi.
| Pole | Opis |
|---|---|
enabled Boolean! |
Określa, czy limity odpowiedzi w formularzu są włączone. |
limit Int |
Maksymalna liczba odpowiedzi, które można przesłać w formularzu. |
FormShortenedLink
Obiekt zawierający konfigurację skróconego adresu URL formularza.
| Pole | Opis |
|---|---|
enabled Boolean! |
Określa, czy można generować skrócone adresy URL. |
url String |
Wygenerowany, skrócony adres URL formularza. Dostępny tylko wtedy, gdy skrócone linki są włączone. |
FormQuestion
Tablica obiektów zawierających treść pytań w formularzu w kolejności ich wyświetlania.
| Pole | Opis | Obsługiwane pola |
|---|---|---|
description String |
Opcjonalny tekst zawierający dodatkowe informacje, instrukcje lub przykłady dotyczące pytania. | |
id String! |
Unikatowy identyfikator pytania. | |
options [FormQuestionOption!] |
Opcje dostępne w pytaniach wyboru. Każda opcja określa etykietę wyświetlaną użytkownikowi. | label String! |
required Boolean! |
Określa, czy odpowiedź na pytanie jest wymagana do wysłania formularza. | |
settings FormQuestionSettings |
Obiekt zawierający konfigurację właściwą dla typu pytania. | checkedByDefault BooleandefaultCurrentDate Booleandisplay FormQuestionSelectDisplayincludeTime Booleanlimit IntlocationAutofilled BooleanoptionsOrder FormQuestionSelectOrderByOptionsprefill PrefillSettingsprefixAutofilled BooleanprefixPredefined PhonePrefixPredefinedskipValidation Boolean |
show_if_rules JSON |
Reguły logiki warunkowej określające, czy pytanie jest wyświetlane na podstawie odpowiedzi na inne pytania. Dostępne tylko w wersji 2026-07 i nowszych. Aliasa camelCase showIfRules usunięto w wersji 2026-10 - użyj zamiast niego show_if_rules. |
|
title String! |
Tytuł pytania. Musi zawierać co najmniej jeden znak. | |
type FormQuestionType |
Typ pytania. Określa sposób wprowadzania danych i ich walidację. | |
visible Boolean! |
Określa, czy pytanie jest widoczne dla respondentów. Ukryte pytania pozostają w strukturze formularza, ale nie są wyświetlane respondentom. |
FormQuestionOption
Tablica zawierająca dostępne opcje w pytaniach wyboru.
| Pole | Opis |
|---|---|
label String! |
Tekst wyświetlany przy poszczególnych opcjach wyboru (w pytaniach typu select). |
FormQuestionSettings
Obiekt zawierający konfigurację właściwą dla typu pytania w formularzu. Jeśli podasz ustawienie właściwe dla konkretnego typu (np. includeTime), formularz musi zawierać pytanie tego typu. W przeciwnym razie mutacja nie zadziała.
| Pole | Opis | Wartości typu enum | Obsługiwane pola |
|---|---|---|---|
checkedByDefault Boolean |
Określa, czy pole wyboru ma być domyślnie zaznaczone. Dotyczy tylko pytań typu Boolean i Checkbox. | ||
defaultCurrentDate Boolean |
Określa, czy bieżąca data jest ustawiana jako wartość domyślna. Dotyczy tylko pytań dotyczących daty. | ||
display FormQuestionSelectDisplay |
Opcje wyświetlania pytań typu select. Dotyczy tylko pytań jednokrotnego lub wielokrotnego wyboru. | DropdownHorizontalVertical |
|
includeTime Boolean |
Określa, czy selektor daty zawiera wybór godziny i minut. Jeśli wartość to false, uwzględniana jest tylko data. Dotyczy tylko pytań dotyczących daty. |
||
limit Int |
Maksymalna wartość oceny, którą można wybrać. Dotyczy tylko pytań dotyczących oceny. | ||
locationAutofilled Boolean |
Określa, czy lokalizacja respondenta jest automatycznie wykrywana i wstawiana. Wykorzystywane są do tego usługi geolokalizacyjne przeglądarki. Wymagana jest zgoda użytkownika. Dotyczy tylko pytań dotyczących lokalizacji. | ||
optionsOrder FormQuestionSelectOrderByOptions |
Opcje sortowania odpowiedzi w pytaniach typu select. Dotyczy tylko pytań jednokrotnego lub wielokrotnego wyboru. | AlphabeticalCustomRandom |
|
prefill PrefillSettings |
Konfiguracja automatycznego wypełniania wartości pytań. | enabled Boolean!lookup String!source FormQuestionPrefillSources |
|
prefixAutofilled Boolean |
Określa, czy prefiks kraju numeru telefonu jest automatycznie wykrywany i wstawiany. Wykorzystywana jest do tego lokalizacja respondenta lub ustawienia przeglądarki. Dotyczy tylko pytań dotyczących numeru telefonu. | ||
prefixPredefined PhonePrefixPredefined |
Konfiguracja wstępnie zdefiniowanego prefiksu kraju dla numeru telefonu, który zostanie wstępnie wybrany dla respondentów. Dotyczy tylko pytań dotyczących numeru telefonu. | enabled Boolean!prefix String |
|
skipValidation Boolean |
Określa, czy walidacja formatu adresu URL jest pomijana, co pozwala wprowadzić dowolny tekst. Dotyczy tylko pytań dotyczących linku lub adresu URL. |
PhonePrefixPredefined
Definiuje konfigurację wstępnego wyboru prefiksu kraju dla numeru telefonu respondenta.
| Pole | Opis |
|---|---|
enabled Boolean! |
Określa, czy dla pytań o numer telefonu włączono wstępnie zdefiniowany prefiks kraju. Jeśli wartość to true, wskazany prefiks zostanie wstępnie wybrany. |
prefix String |
Wstępnie zdefiniowany prefiks kraju zapisany wielkimi literami (np. „US”, „UK”). |
PrefillSettings
Definiuje konfigurację automatycznego wypełniania wartości pytań.
| Pole | Opis | Wartości typu enum |
|---|---|---|
enabled Boolean! |
Określa, czy automatyczne wypełnianie pytania jest włączone. Jeśli wartość to true, wartości zostaną automatycznie pobrane ze wskazanego źródła. |
|
lookup String! |
Nazwa pola lub parametru do wyszukania w źródle danych do wstępnego wypełniania. W przypadku źródeł Account jest to właściwość użytkownika, np. imię i nazwisko lub adres e-mail. W przypadku źródeł QueryParam jest to nazwa parametru ustawionego w adresie URL. |
|
source FormQuestionPrefillSources |
Źródła danych do wstępnego wypełniania wartości pytań. | AccountQueryParam |
FormQuestionType
Obsługiwane wartości typu enum FormQuestionType.
| Boolean | ConnectedBoards | Country | Date | DateRange | File | |
| Link | Location | LongText | MultiSelect | Name | Number | People |
| Phone | Rating | ShortText | Signature | SingleSelect | Subitems | Updates |
Następujące wartości są dostępne w wersji API 2026-07 i nowszych:
HOUR |
DISPLAY_TEXT |
PAGE_BLOCK |
|---|---|---|
FormTag
Tablica tagów śledzących służących do kategoryzacji i analityki.
query {
form(formToken: "YOUR_FORM_TOKEN") {
tags {
id
name
value
columnId
}
}
}
{
"data": {
"form": {
"tags": [
{
"id": "8f2a91c4-6d9a-49c3-bf12-93b4f019d7e1",
"columnId": "short_textxjwe48lm",
"value": "ENGLISH",
"name": "LANGUAGE"
}
]
}
},
"extensions": {
"request_id": "2d74c9f0-5b21-4e68-a123-8f91bb47e0cd"
}
}
❗️ Zmiana powodująca niezgodność wsteczną w wersji
2026-10Pole
valuew typieFormTagzostało usunięte w wersji API2026-10. Przed przejściem na wersję2026-10usuń ze wszystkich zapytań dotyczących tagów formularza żądania polavalue.
| Pole | Opis |
|---|---|
columnId String! |
Unikatowy identyfikator kolumny powiązanej z tagiem. |
id String! |
Unikatowy identyfikator tagu. |
name String! |
Nazwa tagu. |
ResponseForm
Obiekt zawierający informacje o dostępności, wyglądzie, funkcjach, pytaniach i tagach formularza.
| Pole | Opis | Obsługiwane pola podrzędne |
|---|---|---|
accessibility FormAccessibility |
Ustawienia dostępności formularza. | language StringlogoAltText String |
active Boolean! |
Określa, czy formularz jest widoczny i przyjmuje odpowiedzi. | |
appearance FormAppearance |
Ustawienia stylu wizualnego formularza. | background FormBackgroundhideBranding Boolean!layout FormLayoutlogo FormLogoprimaryColor StringshowProgressBar Boolean!submitButton FormSubmitButtontext FormText |
createWithAi Boolean! |
Określa, czy formularz został pierwotnie utworzony za pomocą kreatora formularzy monday.com wspieranego przez AI. | |
description String |
Opcjonalny opis formularza wyświetlany pod tytułem. | |
features FormFeatures |
Ustawienia przełączników i funkcji formularza. | afterSubmissionView FormAfterSubmissionViewcloseDate FormCloseDatedraftSubmission FormDraftSubmissionisInternal Boolean!monday FormMondaypassword FormPasswordpreSubmissionView FormPreSubmissionViewreCaptchaChallenge Boolean!requireLogin FormRequireLoginresponseLimit FormResponseLimitshortenedLink FormShortenedLink |
id Int! |
Unikatowy identyfikator widoku formularza na tablicy. | |
isAnonymous Boolean! |
Określa, czy odpowiedzi są zbierane anonimowo. | |
ownerId Int |
Identyfikator użytkownika będącego właścicielem lub twórcą formularza. | |
questions [FormQuestion!] |
Tablica obiektów pytań tworzących formularz, uporządkowanych według kolejności wyświetlania. | description Stringid String!options [FormQuestionOption!]required Boolean!settings FormQuestionSettingsshow_if_rules JSONtitle String!type FormQuestionTypevisible Boolean! |
tags [FormTag!] |
Tagi śledzące służące do kategoryzacji i analityki. | columnId String!id String!name String!value String |
title String! |
Tytuł wyświetlany u góry formularza. | |
token String! |
Unikatowy token formularza w postaci ciągu znaków. Używany w zapytaniach i mutacjach API. | |
type String |
Typ formularza. |
SetFormPasswordInput
Obiekt definiujący hasło do formularza.
| Pole | Typ | Opis |
|---|---|---|
| password | String! |
Hasło do formularza. |
UpdateFormInput
Obiekt definiujący właściwości formularza do zaktualizowania.
| Pole | Opis | Obsługiwane pola |
|---|---|---|
description String |
Zaktualizowany opis formularza. | |
questions [QuestionOrderInput!] |
Uporządkowana tablica wszystkich identyfikatorów pytań w formularzu. Musi zawierać identyfikator każdego istniejącego pytania. Ich kolejność określa kolejność wyświetlania pytań. | id String! page_block_id String (wersja 2026-07 i nowsze) |
title String |
Zaktualizowany tytuł formularza. Musi zawierać co najmniej jeden znak. |
UpdateFormSettingsInput
Obiekt definiujący ustawienia formularza do zaktualizowania.
| Pole | Opis | Obsługiwane pola |
|---|---|---|
accessibility FormAccessibilityInput |
Zaktualizowane ustawienia dostępności formularza. | language StringlogoAltText String |
appearance FormAppearanceInput |
Zaktualizowane ustawienia stylu wizualnego formularza. | background FormBackgroundInputhideBranding Booleanlayout FormLayoutInputlogo FormLogoInputprimaryColor StringshowProgressBar BooleansubmitButton FormSubmitButtonInputtext FormTextInputis_anonymous Boolean (wersja 2026-07 i nowsze) |
features FormFeaturesInput |
Zaktualizowane ustawienia przełączników i funkcji formularza. | afterSubmissionView FormAfterSubmissionViewInputcloseDate FormCloseDateInputdraftSubmission FormDraftSubmissionInputmonday FormMondayInputpassword FormPasswordInputpreSubmissionView FormPreSubmissionViewInputreCaptchaChallenge BooleanrequireLogin FormRequireLoginInputresponseLimit FormResponseLimitInputai_translate Boolean (wersja 2026-07 i nowsze) |
FormAccessibilityInput
Obiekt zawierający zaktualizowane dane wejściowe dla ustawień dostępności formularza.
| Pole | Opis |
|---|---|
language String |
Kod języka określający lokalizację formularza i tekst interfejsu (np. „es”, „en”, „fr”). |
logoAltText String |
Tekst alternatywny opisujący logo formularza. |
FormAppearanceInput
Obiekt zawierający zaktualizowane dane wejściowe określające ogólny wygląd formularza (np. tło, układ, kolory i typografię).
| Pole | Opis | Obsługiwane pola |
|---|---|---|
background FormBackgroundInput |
Obiekt zawierający zaktualizowane dane wejściowe konfiguracji tła formularza. | type FormBackgrounds!value String |
hideBranding Boolean |
Określa, czy branding monday.com jest ukryty. | |
layout FormLayoutInput |
Obiekt zawierający zaktualizowane dane wejściowe dotyczące struktury i prezentacji formularza. | alignment FormAlignmentdirection FormDirectionformat FormFormat |
logo FormLogoInput |
Obiekt zawierający zaktualizowane dane wejściowe konfiguracji wyświetlania logo formularza. | position FormLogoPositionsize FormLogoSizeurl String |
primaryColor String |
Kod koloru HEX głównego koloru motywu używanego w formularzu. | |
showProgressBar Boolean |
Określa, czy wyświetlany jest wskaźnik postępu wypełniania formularza. | |
submitButton FormSubmitButtonInput |
Obiekt zawierający zaktualizowane dane wejściowe konfiguracji przycisku wysyłania formularza. | text String |
text FormTextInput |
Obiekt zawierający zaktualizowane dane wejściowe konfiguracji typografii i stylów tekstu formularza. | color Stringfont Stringsize FormFontSize |
FormBackgroundInput
Konfiguruje zaktualizowane tło formularza (np. kolor, obraz lub jego brak).
| Pole | Opis | Wartości typu enum |
|---|---|---|
type FormBackgrounds! |
Typ tła formularza. | ColorImageNone |
value String |
Wartość tła formularza.
|
FormLayoutInput
Definiuje zaktualizowane dane wejściowe układu, wyrównania i formatu formularza.
❗️ Zmiana powodująca niezgodność wsteczną w wersji
2026-10Pole
formatzostało usunięte w wersji API2026-10. Przed przejściem na wersję2026-10usuń poleformatz danych wejściowychFormLayoutInput.
| Pole | Opis | Wartości typu enum |
|---|---|---|
alignment FormAlignment |
Wyrównanie tekstu i zawartości formularza. | CenterFullLeftFullRightLeftRight |
direction FormDirection |
Kierunek czytania formularza. | LtRRtl |
FormLogoInput
Konfiguruje zaktualizowane dane wejściowe logo formularza (np. jego położenie, rozmiar i adres URL obrazu).
| Pole | Opis | Wartości typu enum |
|---|---|---|
position FormLogoPosition |
Położenie logo formularza. | AutoCenterLeftRight |
size FormLogoSize |
Rozmiar logo formularza. | ExtraLarge (wysokość 96px)Large (wysokość 72px)Medium (wysokość 40px)Small (wysokość 32px) |
FormSubmitButtonInput
Definiuje zaktualizowany tekst przycisku wysyłania formularza.
| Pole | Opis |
|---|---|
text String |
Niestandardowy tekst wyświetlany na przycisku wysyłania formularza. |
FormTextInput
Definiuje zaktualizowane dane wejściowe konfiguracji typografii formularza.
| Pole | Opis | Wartości typu enum |
|---|---|---|
color String |
Kod koloru HEX tekstu formularza. | |
font String |
Krój pisma używany w formularzu. | |
size FormFontSize |
Podstawowy rozmiar tekstu formularza. | LargeMediumSmall |
FormFeaturesInput
Obiekt zawierający dane wejściowe dla funkcji dostępnych na poziomie formularza, takich jak wymóg logowania, limity odpowiedzi i ochrona hasłem.
| Pole | Opis | Obsługiwane pola |
|---|---|---|
afterSubmissionView FormAfterSubmissionViewInput |
Obiekt zawierający zaktualizowane dane wejściowe konfiguracji formularza po jego wysłaniu. | allowEditSubmission BooleanallowResubmit BooleanallowViewSubmission Booleandescription StringredirectAfterSubmission FormRedirectAfterSubmissionInputshowSuccessImage Booleantitle String |
closeDate FormCloseDateInput |
Obiekt zawierający zaktualizowane dane wejściowe konfiguracji automatycznego zamknięcia formularza. | date Stringenabled Boolean |
draftSubmission FormDraftSubmissionInput |
Obiekt zawierający zaktualizowane dane wejściowe konfiguracji zapisywania wersji roboczych formularza. | enabled Boolean |
monday FormMondayInput |
Obiekt zawierający zaktualizowane dane wejściowe ustawień tablicy dotyczących obsługi odpowiedzi. | includeNameQuestion BooleanincludeUpdateQuestion BooleanitemGroupId StringsyncQuestionAndColumnsTitles Boolean |
password FormPasswordInput |
Obiekt zawierający zaktualizowane dane wejściowe konfiguracji ochrony formularza hasłem. | enabled Boolean |
preSubmissionView FormPreSubmissionViewInput |
Obiekt zawierający zaktualizowane dane wejściowe konfiguracji ekranu powitalnego. | description Stringenabled BooleanstartButton FormStartButtonInputtitle String |
reCaptchaChallenge Boolean |
Określa, czy w formularzu włączono weryfikację reCAPTCHA, aby zapobiec wysyłaniu spamu. | |
requireLogin FormRequireLoginInput |
Obiekt zawierający zaktualizowane dane wejściowe ustawień wymogu logowania do formularza. | enabled BooleanredirectToLogin Boolean |
responseLimit FormResponseLimitInput |
Obiekt zawierający zaktualizowane dane wejściowe ustawień limitu odpowiedzi. | enabled Booleanlimit Int |
FormAfterSubmissionViewInput
Obiekt zawierający zaktualizowane ustawienia formularza po jego wysłaniu.
| Pole | Opis | Obsługiwane pola |
|---|---|---|
allowEditSubmission Boolean |
Określa, czy użytkownicy mogą edytować swoje odpowiedzi po wysłaniu formularza. | |
allowResubmit Boolean |
Określa, czy użytkownicy mogą wielokrotnie wysyłać odpowiedzi w tym samym formularzu. | |
allowViewSubmission Boolean |
Określa, czy użytkownicy mogą wyświetlić swoje odpowiedzi po wysłaniu formularza. | |
description String |
Tekst wyświetlany po wysłaniu formularza. | |
redirectAfterSubmission FormRedirectAfterSubmissionInput |
Obiekt zawierający konfigurację przekierowania po wysłaniu formularza. | enabled BooleanredirectUrl String |
showSuccessImage Boolean |
Określa, czy po wysłaniu formularza wyświetlany jest obraz potwierdzający powodzenie. | |
title String |
Tytuł wyświetlany po wysłaniu formularza. |
FormRedirectAfterSubmissionInput
Obiekt zawierający zaktualizowane dane wejściowe konfiguracji przekierowania po wysłaniu formularza.
| Pole | Opis |
|---|---|
enabled Boolean |
Określa, czy po wypełnieniu formularza respondenci są automatycznie przekierowywani pod wskazany adres URL. |
redirectUrl String |
Adres URL, pod który użytkownicy są przekierowywani po pomyślnym wypełnieniu formularza. |
FormCloseDateInput
Obiekt zawierający zaktualizowane dane wejściowe konfiguracji automatycznego zamknięcia formularza.
| Pole | Opis |
|---|---|
date String |
Znacznik czasu ISO 8601 określający, kiedy formularz automatycznie przestanie przyjmować odpowiedzi. |
enabled Boolean |
Określa, czy formularz jest automatycznie zamykany w określonym dniu i o określonej godzinie. |
FormDraftSubmissionInput
Obiekt zawierający zaktualizowane dane wejściowe konfiguracji zapisywania wersji roboczych formularza.
| Pole | Opis |
|---|---|
enabled Boolean |
Określa, czy użytkownicy mogą zapisywać nieukończone odpowiedzi jako wersje robocze. |
FormMondayInput
Obiekt zawierający zaktualizowane dane wejściowe ustawień tablicy dotyczących obsługi odpowiedzi w formularzu.
| Pole | Opis |
|---|---|
includeNameQuestion Boolean |
Określa, czy do formularza dodawane jest pytanie o imię i nazwisko. Odpowiada ono kolumnie nazwy elementu na tablicy. |
includeUpdateQuestion Boolean |
Określa, czy do formularza dodawane jest pole aktualizacji. Odpowiada ono sekcji aktualizacji powiązanego elementu. |
itemGroupId String |
Identyfikator grupy na tablicy, w której na podstawie odpowiedzi z formularza zostaną utworzone nowe elementy. |
syncQuestionAndColumnsTitles Boolean |
Określa, czy tytuł pytania w formularzu jest synchronizowany z nazwą kolumny na tablicy. |
allow_create_item Boolean |
Określa, czy wysłanie formularza powoduje utworzenie nowego elementu na połączonej tablicy. Dostępne tylko w wersji 2026-07 i nowszych. |
FormPasswordInput
Obiekt zawierający zaktualizowane dane wejściowe konfiguracji ochrony formularza hasłem.
| Pole | Opis |
|---|---|
enabled Boolean |
Określa, czy użytkownicy muszą podać hasło, aby uzyskać dostęp do formularza. To ustawienie można wykorzystać tylko do wyłączenia ochrony hasłem. Aby ją włączyć, użyj mutacji set_form_password. |
FormPreSubmissionViewInput
Obiekt zawierający zaktualizowane dane wejściowe dla ustawień opcjonalnego ekranu powitalnego wyświetlanego przed rozpoczęciem formularza.
| Pole | Opis | Obsługiwane pola |
|---|---|---|
description String |
Tekst wyświetlany na ekranie powitalnym. | |
enabled Boolean |
Określa, czy przed rozpoczęciem formularza wyświetlany jest ekran powitalny. | |
startButton FormStartButtonInput |
Obiekt zawierający zaktualizowane dane wejściowe konfiguracji przycisku rozpoczęcia na ekranie powitalnym formularza. | text String |
title String |
Tytuł wyświetlany na ekranie powitalnym. |
FormRequireLoginInput
Obiekt zawierający zaktualizowane dane wejściowe ustawień wymogu logowania do formularza.
| Pole | Opis |
|---|---|
enabled Boolean |
Określa, czy użytkownicy muszą się zalogować przed wysłaniem odpowiedzi. |
redirectToLogin Boolean |
Określa, czy nieuwierzytelnieni użytkownicy są automatycznie przekierowywani na stronę logowania. |
FormResponseLimitInput
Obiekt zawierający zaktualizowane dane wejściowe ustawień limitu odpowiedzi.
| Pole | Opis |
|---|---|
enabled Boolean |
Określa, czy limity odpowiedzi w formularzu są włączone. |
limit Int |
Maksymalna liczba odpowiedzi, które można przesłać w formularzu. |
UpdateFormTagInput
❗️ Usunięty w wersji
2026-10Typ
UpdateFormTagInputi mutacjaupdate_form_tagzostały usunięte w wersji API2026-10. Przed przejściem na tę wersję usuń wszystkie ich użycia.
Obiekt zawierający zaktualizowane tagi pytania (usunięte w wersji 2026-10).
| Pole | Typ | Opis |
|---|---|---|
| value | String |
Zaktualizowana wartość tagu. |
UpdateQuestionInput
Obiekt zawierający zaktualizowane właściwości pytania.
| Pole | Opis | Obsługiwane pola |
|---|---|---|
description String |
Zaktualizowany opis pytania. | |
required Boolean |
Określa, czy odpowiedź na pytanie jest wymagana do wysłania formularza. | |
settings FormQuestionSettingsInput |
Zaktualizowane ustawienia właściwe dla typu pytania. | checkedByDefault BooleandefaultCurrentDate Booleandisplay FormQuestionSelectDisplayincludeTime BooleanlocationAutofilled BooleanoptionsOrder FormQuestionSelectOrderByOptionsprefill PrefillSettingsInputprefixAutofilled BooleanprefixPredefined PhonePrefixPredefinedInputskipValidation Boolean |
title String |
Zaktualizowany tytuł pytania. | |
type FormQuestionType! |
Zaktualizowany typ pytania, który określa sposób wprowadzania danych i ich walidację. Nie można przekazać nowego typu pytania - musi on być zgodny z typem istniejącego pytania. | |
visible Boolean |
Określa, czy pytanie jest widoczne dla respondentów. Ukryte pytania pozostają w strukturze formularza, ale nie są wyświetlane respondentom. | |
show_if_rules JSON |
Zaktualizowane reguły logiki warunkowej dla tego pytania. Dostępne tylko w wersji 2026-07 i nowszych. |
|
options [QuestionOptionInput!] |
Zaktualizowane opcje w pytaniach wyboru. Dostępne tylko w wersji 2026-07 i nowszych. |
FormQuestionSettingsInput
Obiekt zawierający zaktualizowaną konfigurację właściwą dla typu pytania. Jeśli podasz ustawienie właściwe dla konkretnego typu (np. includeTime), formularz musi zawierać pytanie tego typu. W przeciwnym razie mutacja nie zadziała.
| Pole | Opis | Wartości typu enum | Obsługiwane pola |
|---|---|---|---|
checkedByDefault Boolean |
Określa, czy pole wyboru ma być domyślnie zaznaczone. Dotyczy tylko pytań typu Boolean i Checkbox. | ||
defaultCurrentDate Boolean |
Określa, czy bieżąca data jest ustawiana jako wartość domyślna. Dotyczy tylko pytań dotyczących daty. | ||
display FormQuestionSelectDisplay |
Opcje wyświetlania pytań typu select. Dotyczy tylko pytań jednokrotnego lub wielokrotnego wyboru. | DropdownHorizontalVertical |
|
includeTime Boolean |
Określa, czy selektor daty zawiera wybór godziny i minut. Jeśli wartość to false, uwzględniana jest tylko data. Dotyczy tylko pytań dotyczących daty. |
||
locationAutofilled Boolean |
Określa, czy lokalizacja respondenta jest automatycznie wykrywana i wstawiana. Wykorzystywane są do tego usługi geolokalizacyjne przeglądarki. Wymagana jest zgoda użytkownika. Dotyczy tylko pytań dotyczących lokalizacji. | ||
optionsOrder FormQuestionSelectOrderByOptions |
Opcje sortowania odpowiedzi w pytaniach typu select. Dotyczy tylko pytań jednokrotnego lub wielokrotnego wyboru. | AlphabeticalCustomRandom |
|
prefill PrefillSettingsInput |
Konfiguracja automatycznego wypełniania wartości pytań. | enabled Boolean!lookup Stringsource FormQuestionPrefillSources |
|
prefixAutofilled Boolean |
Określa, czy prefiks kraju numeru telefonu jest automatycznie wykrywany i wstawiany. Wykorzystywana jest do tego lokalizacja respondenta lub ustawienia przeglądarki. Dotyczy tylko pytań dotyczących numeru telefonu. | ||
prefixPredefined PhonePrefixPredefinedInput |
Konfiguracja wstępnie zdefiniowanego prefiksu kraju dla numeru telefonu, który zostanie wstępnie wybrany dla respondentów. Dotyczy tylko pytań dotyczących numeru telefonu. | enabled Boolean!prefix String |
|
skipValidation Boolean |
Określa, czy walidacja formatu adresu URL jest pomijana, co pozwala wprowadzić dowolny tekst. Dotyczy tylko pytań dotyczących linku lub adresu URL. | ||
label_limit_count_enabled Boolean |
Określa, czy przy pytaniach tekstowych wyświetlany jest limit liczby znaków. Dostępne tylko w wersji 2026-07 i nowszych. |
||
default_answer String |
Domyślna odpowiedź wstawiana po wyświetleniu pytania. Dostępne tylko w wersji 2026-07 i nowszych. |
PhonePrefixPredefinedInput
Definiuje konfigurację wstępnego wyboru prefiksu kraju dla numeru telefonu respondenta.
| Pole | Opis |
|---|---|
enabled Boolean! |
Określa, czy dla pytań o numer telefonu włączono wstępnie zdefiniowany prefiks kraju. Jeśli wartość to true, wskazany prefiks zostanie wstępnie wybrany. |
prefix String |
Wstępnie zdefiniowany prefiks kraju zapisany wielkimi literami (np. „US”, „UK”). |
PrefillSettingsInput
Definiuje konfigurację automatycznego wypełniania wartości pytań.
| Pole | Opis | Wartości typu enum |
|---|---|---|
enabled Boolean! |
Określa, czy automatyczne wypełnianie pytania jest włączone. Jeśli wartość to true, wartości zostaną automatycznie pobrane ze wskazanego źródła. |
|
lookup String |
Nazwa pola lub parametru do wyszukania w źródle danych do wstępnego wypełniania. W przypadku źródeł Account jest to właściwość użytkownika, np. imię i nazwisko lub adres e-mail. W przypadku źródeł QueryParam jest to nazwa parametru ustawionego w adresie URL. |
|
source FormQuestionPrefillSources |
Źródła danych do wstępnego wypełniania wartości pytań. | AccountQueryParam |