Wartości pól

Kształt cellValues dla każdego typu pola: tekst, status, osoby, daty, relacje, lokalizacje i inne.

Na tej stronie

Wartości rekordu wysyłasz w obiekcie cellValues, w którym kluczem jest identyfikator pola, a wartością dane w kształcie zależnym od typu pola.

cellValues

{
  "cellValues": {
    "<id pola tekstowego>": "Kawiarnia Ziarno",
    "<id pola statusu>": "<id opcji statusu>",
    "<id pola osób>": ["<id użytkownika>"]
  }
}

Tekst i liczby

Typ pola	`type`	Wartość
Tekst	`text`	`"Kawiarnia Ziarno"`
Notatki	`long-text`	`"Dłuższy opis…"`
Tekst sformatowany	`rich-text`	Napis z HTML, na przykład `"<p>Treść</p>"`
Markdown	`markdown`	`"Ważne: zadzwonić"`
Liczba	`number`	`1250.5`
Ocena	`rating`	Liczba od 0 do maksimum z ustawień pola, na przykład `4`
Tak/Nie	`boolean`	`true` albo `false`
Adres mailowy	`mail`	`"[email protected]"`
Telefon	`phone`	`"+48 600 100 200"`
Link	`link`	`{"url": "https://ziarno.pl"}`

Wybór

Typ pola	`type`	Wartość
Status	`status`	Identyfikator opcji statusu, na przykład `"65a1f0c2b3d4e5f601234567"`
Etykiety	`dropdown`	Lista identyfikatorów etykiet, na przykład `["…", "…"]`
Osoby	`people`	Lista identyfikatorów użytkowników. Gdy pole przyjmuje jedną osobę, lista ma jeden element

Dostępne opcje pola pobierzesz przez GET /property/:databasePropertyId/possible-values.

Data

Data to zawsze obiekt z kluczami from i to, a każdy z nich ma date w formacie yyyy-MM-dd i time w formacie HH:mm. Wszystkie cztery klucze muszą być obecne. Sam napis z datą zostanie odrzucony.

{
  "from": {"date": "2026-10-02", "time": null},
  "to": {"date": null, "time": null}
}

Jeśli pole nie przyjmuje zakresu, wyślij to.date jako null. Powtórzenie tej samej daty w to zapisze zakres, którego pole nie wyświetli. Jeśli pole nie przyjmuje godziny, oba klucze time mają wartość null.

Relacje

Typ pola	`type`	Wartość
Relacja	`relation`	Lista identyfikatorów rekordów z powiązanej bazy
Odwrócona relacja	`reverse-relation`	Lista identyfikatorów rekordów

Teleportacja, pola obliczeniowe i pola systemowe liczą się same, więc ich nie zapisujesz.

Lokalizacja

{
  "address": "ul. Piotrkowska 104, 90-001 Łódź",
  "displayAddress": "Piotrkowska 104, Łódź",
  "coordinates": [19.4573, 51.7651],
  "addressComponents": {}
}

Współrzędne podajesz w kolejności długość, szerokość geograficzna.

Lista kontrolna

{
  "checklistsIds": ["…"],
  "checkedItemIds": ["…"],
  "total": 4,
  "completed": 1
}

Pliki

Pola z plikami nie da się ustawić przez cellValues. Pliki dodajesz osobnym przesłaniem, a przez MCP narzędziami create_file_upload_link i confirm_file_upload. Zobacz Narzędzia i zasoby MCP.

Wartości w odpowiedziach

W odpowiedziach każda wartość jest opakowana w obiekt z typem:

Odpowiedź

{
  "65a1f0c2b3d4e5f601234567": {"value": "Kawiarnia Ziarno", "valueType": "text"}
}

Gdy wartość pochodzi z powiązanego rekordu, na przykład przez teleportację, obiekt ma też sourceItemId.

Błędna wartość

Wartość w złym kształcie kończy się błędem 400 o nazwie INVALID_FIELD_VALUE, z opisem, co jest nie tak. Więcej w przewodniku Błędy i limity.