---

Kolumna ostatniej aktualizacji wyświetla, kiedy element był ostatnio modyfikowany i kto go zaktualizował. Jej wartość jest uzupełniana automatycznie przez system - nie można jej bezpośrednio zmienić ani wyczyścić.

Za pomocą API kolumna ostatniej aktualizacji obsługuje operacje odczytu, filtrowania i tworzenia.

Typ kolumny	Typ implementacji	Obsługiwane operacje
last_updated	LastUpdatedValue	Odczyt: Tak Filtrowanie: Tak Tworzenie: Tak Aktualizacja: Nie Czyszczenie: Nie

---

Zapytania

Kolumny ostatniej aktualizacji można odpytywać za pomocą pola column_values w zapytaniach dotyczących items, używając wbudowanego fragmentu dla LastUpdatedValue.

query {
  items(ids: [1234567890, 9876543210]) {
    name
    column_values {
      ... on LastUpdatedValue {
        id
        updated_at
        updater_id
        updater {
          id
          name
        }
        text
        value
      }
    }
  }
}

const query = `
  query ($itemIds: [ID!], $columnType: [ColumnType!]) {
    items(ids: $itemIds) {
      name
      column_values(types: $columnType) {
        column { title id }
        ... on LastUpdatedValue {
          updated_at
          updater_id
          updater {
            id
            name
          }
          text
          value
        }
      }
    }
  }
`;

const variables = {
  itemIds: [1234567890, 9876543210],
  columnType: "last_updated"
};

const response = await mondayApiClient.request(query, variables);

Pola

Możesz użyć poniższych pól, aby określić, jakie informacje zwróci implementacja LastUpdatedValue.

Pole	Opis
column Column!	Kolumna, do której należy wartość.
id ID!	Unikalny identyfikator kolumny.
is_leaf Boolean!	Określa, czy element jest elementem końcowym (nie ma podelementów). Zwraca false dla elementów nadrzędnych.
text String	Wartość kolumny w postaci tekstu (np. "2026-03-21 08:47:10 UTC").
type ColumnType!	Typ kolumny.
updated_at Date	Data i godzina ostatniej aktualizacji elementu.
updater User	Użytkownik, który ostatnio zaktualizował element. Zawiera id, name i inne pola użytkownika.
updater_id ID	Unikalny identyfikator użytkownika, który ostatnio zaktualizował element.
value JSON	Surowa wartość kolumny w postaci ciągu JSON. Zwraca {"updated_at": "...", "updater_id": "..."}.

Przykładowa odpowiedź

{
  "data": {
    "items": [
      {
        "name": "Task A",
        "column_values": [
          {
            "id": "last_updated",
            "updated_at": "2026-03-21T08:47:10Z",
            "updater_id": "123456",
            "updater": {
              "id": "123456",
              "name": "John Doe"
            },
            "text": "2026-03-21 08:47:10 UTC",
            "value": "{\"updated_at\":\"2026-03-21T08:47:10Z\",\"updater_id\":\"123456\"}"
          }
        ]
      }
    ]
  }
}

---

Filtrowanie

Możesz filtrować elementy według informacji o ich ostatniej aktualizacji za pomocą obiektu items_page.

Możesz filtrować według metadanych ostatniej aktualizacji za pomocą __last_updated__ jako column_id, nawet jeśli kolumna ostatniej aktualizacji nie jest widoczna na tablicy.

Możesz filtrować elementy według:

• Osoby, która ostatnio je zaktualizowała
• Czasu ich ostatniej aktualizacji

Wartość porównywana	Opis	Operatory	Atrybut porównania	Czy atrybut porównania jest wymagany?
"assigned_to_me"	Elementy ostatnio zaktualizowane przez użytkownika wykonującego wywołanie	any_of not_any_of	*	Nie
"person-123456"	Elementy ostatnio zaktualizowane przez konkretnego użytkownika (zastąp 123456 identyfikatorem użytkownika)	any_of not_any_of	*	Nie
"TODAY"	Elementy ostatnio zaktualizowane dzisiaj	any_of not_any_of	"UPDATED_AT"	Tak
"YESTERDAY"	Elementy ostatnio zaktualizowane wczoraj	any_of not_any_of	"UPDATED_AT"	Tak
"THIS_WEEK"	Elementy ostatnio zaktualizowane w tym tygodniu	any_of not_any_of	"UPDATED_AT"	Tak
"LAST_WEEK"	Elementy ostatnio zaktualizowane w zeszłym tygodniu	any_of not_any_of	"UPDATED_AT"	Tak
"THIS_MONTH"	Elementy ostatnio zaktualizowane w tym miesiącu	any_of not_any_of	"UPDATED_AT"	Tak
"LAST_MONTH"	Elementy ostatnio zaktualizowane w zeszłym miesiącu	any_of not_any_of	"UPDATED_AT"	Tak
"PAST_DATETIME"	Elementy zaktualizowane w dowolnym momencie w przeszłości	any_of	"UPDATED_AT"	Tak

Przykłady

Filtrowanie według dzisiejszych aktualizacji

Ten przykład zwraca wszystkie elementy ostatnio zaktualizowane dzisiaj, nawet jeśli na tablicy nie ma widocznej kolumny ostatniej aktualizacji.

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "__last_updated__"
            compare_value: ["TODAY"]
            operator: any_of
            compare_attribute: "UPDATED_AT"
          }
        ]
      }
    ) {
      items {
        id
        name
      }
    }
  }
}

const query = `
  query ($boardId: [ID!], $columnId: ID!, $operator: ItemsQueryRuleOperator!, $compareValue: CompareValue!, $compareAttribute: String!) {
    boards(ids: $boardId) {
      items_page(
        query_params: {
          rules: [
            {
              column_id: $columnId,
              compare_value: $compareValue,
              compare_attribute: $compareAttribute,
              operator: $operator
            }
          ]
        }
      ) {
        items { id name }
      }
    }
  }
`;

const variables = {
  boardId: 1234567890,
  columnId: "__last_updated__",
  compareValue: ["TODAY"],
  compareAttribute: "UPDATED_AT",
  operator: "any_of"
};

const response = await mondayApiClient.request(query, variables);

Filtrowanie według osoby, która ostatnio zaktualizowała element

Ten przykład zwraca wszystkie elementy ostatnio zaktualizowane przez użytkownika 123456.

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "__last_updated__"
            compare_value: ["person-123456"]
            operator: any_of
          }
        ]
      }
    ) {
      items {
        id
        name
      }
    }
  }
}

const query = `
  query ($boardId: [ID!], $columnId: ID!, $operator: ItemsQueryRuleOperator!, $compareValue: CompareValue!) {
    boards(ids: $boardId) {
      items_page(
        query_params: {
          rules: [
            { column_id: $columnId, compare_value: $compareValue, operator: $operator }
          ]
        }
      ) {
        items { id name }
      }
    }
  }
`;

const variables = {
  boardId: 1234567890,
  columnId: "__last_updated__",
  compareValue: ["person-123456"],
  operator: "any_of"
};

const response = await mondayApiClient.request(query, variables);

Filtrowanie według elementów niezaktualizowanych dzisiaj

Ten przykład zwraca elementy, które nie zostały dzisiaj zaktualizowane.

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "__last_updated__"
            compare_value: ["TODAY"]
            operator: not_any_of
            compare_attribute: "UPDATED_AT"
          }
        ]
      }
    ) {
      items {
        id
        name
      }
    }
  }
}

Filtrowanie według elementów zaktualizowanych przez użytkownika wykonującego wywołanie

Ten przykład zwraca elementy ostatnio zaktualizowane przez użytkownika wykonującego wywołanie API.

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "__last_updated__"
            compare_value: ["assigned_to_me"]
            operator: any_of
          }
        ]
      }
    ) {
      items {
        id
        name
      }
    }
  }
}

---

Mutacje

Tworzenie

Wymagany zakres uprawnień: boards:write

Możesz utworzyć kolumnę ostatniej aktualizacji za pomocą ogólnej mutacji create_column. Dla kolumny ostatniej aktualizacji nie ma mutacji tworzenia o określonym typie.

mutation {
  create_column(
    board_id: 1234567890
    title: "Last Updated"
    column_type: last_updated
    defaults: "{\"mode\":\"personAndDate\",\"dateFormatMode\":\"dateAgo\"}"
  ) {
    id
    title
    description
  }
}

const query = `
  mutation ($boardId: ID!, $title: String!, $columnType: ColumnType!, $defaults: JSON) {
    create_column(
      board_id: $boardId
      title: $title
      column_type: $columnType
      defaults: $defaults
    ) {
      id
      title
      description
    }
  }
`;

const variables = {
  boardId: 1234567890,
  title: "Last Updated",
  columnType: "last_updated",
  defaults: "{\"mode\":\"personAndDate\",\"dateFormatMode\":\"dateAgo\"}"
};

const response = await mondayApiClient.request(query, variables);

Argumenty

Argument	Typ	Opis
board_id	ID!	Unikalny identyfikator tablicy.
title	String!	Tytuł kolumny.
column_type	ColumnType!	Musi mieć wartość last_updated.
id	String	Niestandardowy identyfikator kolumny. Jeśli go nie podasz, zostanie wygenerowany automatycznie.
description	String	Opis kolumny.
after_column_id	ID	Identyfikator kolumny, za którą należy wstawić nową kolumnę.
defaults	JSON	Ciąg JSON zawierający ustawienia kolumny. Dostępne właściwości znajdziesz w sekcji ustawienia kolumny.

Właściwości ustawień

Właściwość	Typ	Opis
mode	String	Tryb wyświetlania: "personOnly", "dateOnly" lub "personAndDate".
dateFormatMode	String	Sposób wyświetlania daty: "dateAgo" (względny, np. „2 godziny temu”) lub "dateFormat" (data bezwzględna).

Aktualizowanie i czyszczenie

Kolumna ostatniej aktualizacji jest tylko do odczytu. Nie można zmienić ani wyczyścić jej wartości za pomocą API - system ustawia ją automatycznie za każdym razem, gdy zmienia się wartość dowolnej kolumny elementu.

---

Odczytywanie konfiguracji kolumny

Aby sprawdzić ustawienia wyświetlania kolumny ostatniej aktualizacji, możesz odpytać jej ustawienia za pomocą pola settings kolumny.

query {
  boards(ids: 1234567890) {
    columns(ids: ["last_updated"]) {
      id
      title
      settings
    }
  }
}

Struktura odpowiedzi settings

Pole settings zwraca typowany obiekt JSON zawierający następujące klucze:

Klucz	Typ	Opis
mode	String	Tryb wyświetlania: "personOnly" (pokaż tylko osobę, która zaktualizowała element), "dateOnly" (pokaż tylko datę) lub "personAndDate" (pokaż oba).
dateFormatMode	String	Sposób wyświetlania daty: "dateAgo" (czas względny, np. „2 godziny temu”) lub "dateFormat" (data bezwzględna).

Przykład: ustawienia domyślne

{}

Przykład: ustawienia niestandardowe

{
  "mode": "dateOnly",
  "dateFormatMode": "dateFormat"
}

---

Pobieranie schematu typu kolumny

Możesz programowo pobrać schemat JSON ustawień kolumny ostatniej aktualizacji za pomocą zapytania get_column_type_schema. Zwraca ono strukturę, reguły walidacji i dostępne właściwości konfiguracji kolumny.

query {
  get_column_type_schema(
    type: last_updated
  )
}

{
  "data": {
    "get_column_type_schema": {
      "schema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "settings": {
            "type": "object",
            "description": "Column specific settings",
            "properties": {
              "mode": {
                "type": "string",
                "description": "Display mode for the pulse updated column",
                "enum": [
                  "personOnly",
                  "dateOnly",
                  "personAndDate"
                ]
              },
              "dateFormatMode": {
                "type": "string",
                "description": "How to display the date value",
                "enum": [
                  "dateAgo",
                  "dateFormat"
                ]
              }
            },
            "additionalProperties": false
          }
        }
      }
    }
  }
}

Odpowiedź zawiera nazwy właściwości, typy, ograniczenia (takie jak maksymalna długość i dozwolone wartości) oraz opisy poszczególnych ustawień. Możesz jej użyć do walidowania ustawień kolumn, dynamicznego generowania interfejsów lub przekazywania kontekstu agentom AI. Dowiedz się więcej o formacie odpowiedzi schematu.