Istotna aktualizacja encji użytkownika

Typ GraphQL User i Query.users zmieniają się w dwóch wersjach API:

• 2026-07: Nowe pola, typy, wyliczenia, argumenty Query.users, zapytanie user_configs oraz bardziej rygorystyczna paginacja w users.
• 2026-10: Usunięcie starszych pól typu User jest planowane. Termin usunięcia zależy od schematu API opublikowanego dla Twojej wersji. Zmigruj ze starszych pól, gdy tylko zaczniesz korzystać z wersji 2026-07 lub nowszej.

Jeśli używasz tylko User.id, User.email, User.name i User.kind, nie musisz wprowadzać zmian w tych polach. Jeśli używasz pól z adresami URL zdjęć, wartości logicznych dotyczących typu lub statusu, is_verified, join_date albo wcześniejszych argumentów users(kind: …, newest_first: …, non_active: …), zapoznaj się z poniższymi sekcjami.

Przykłady migracji krok po kroku znajdziesz w sekcjach User i users w dokumentacji API monday.com dla wersji API, z której korzystasz.

---

Zmiany w wersji 2026-07

Nowe pola typu User

Pole	Typ	Opis
account_id	ID!	Konto, do którego należy użytkownik.
status	UserStatus!	Status aktywacji: ACTIVE, INACTIVE lub PENDING.
invitation_method	InvitationMethod!	Sposób dodania użytkownika do konta.
serial_number	Int	Numer porządkowy użytkownika na koncie.
is_deleted	Boolean!	Określa, czy użytkownik został usunięty logicznie.
photo_url	PhotoUrl	Zagnieżdżony obiekt zawierający adresy URL zdjęcia w różnych rozmiarach. Zastępuje płaskie pola photo_*.
became_active_at	ISO8601DateTime	Data i godzina aktywacji użytkownika. Zastępuje join_date.
bb_visitor_id	ID!	Nieprzezroczysty identyfikator użytkownika na platformie, który pozostaje niezmienny w obrębie konta.
is_email_confirmed	Boolean!	Określa, czy użytkownik potwierdził swój adres e-mail. Zastępuje is_verified.
user_config	UserConfig!	Konfiguracja zależna od typu użytkownika (identyfikator roli, widoczność). Wymaga uprawnienia users:read.

Istniejące pola (zmiany typów w wersji 2026-07)

W wersji 2026-07 te pola mają również zaktualizowany typ:

• User.created_at: Date → ISO8601DateTime!
• User.birthday: Date → String (niezgodna wstecz zmiana typu)
• User.utc_hours_diff: Int → Float (niezgodna wstecz zmiana typu)

Pola email, name, kind i created_at pozostają dostępne. Zmieniają się tylko typy wskazane powyżej.

Nowe typy

• PhotoUrl - original, small, thumb, thumb_small, tiny (każde pole typu String).
• UserConfig - kind: String!, role_id: ID!, visibility: [String!]!.

Nowe wyliczenia

• UserStatus: ACTIVE, INACTIVE, PENDING.
• InvitationMethod: USER, SCIM, SSO, AUTH_DOMAIN, FIRST_USER, CONSOLIDATION, INTERNAL_CREATION, UNKNOWN, SERVICE_PORTAL_AUTH_DOMAIN, SERVICE_PORTAL_USER_INVITATION, API_USER_CREATION.
• UserKindFilter: Poszczególne typy użytkowników (ADMIN, MEMBER, GUEST, VIEW_ONLY, AGENT_MEMBER, PORTAL), grupy typów (BASIC = admin + member + guest + view_only) oraz typy użytkowników API (PORTFOLIO_API_USER, NEXUS_API_USER, RESOURCE_DIRECTORY_API_USER, OMNICHANNEL_API_USER, GOALS_API_USER, PROJECTS_API_USER, SPRINT_MANAGEMENT_API_USER, CRM_COMMERCE_API_USER, CAMPAIGNS_API_USER, DATA_RETENTION_API_USER, MONDAY_SERVICE_API_USER, AI_PLATFORM_AGENT_API_USER, DEPENDENCIES_API_USER, HISTORICAL_TRACKING_BACKFILL_API_USER).
• UsersSortField: CREATED_AT.
• UsersSortDirection: ASC, DESC.

Nowe typy wejściowe

• UserKindFilterInput: in: [UserKindFilter!], not_in: [UserKindFilter!].
• UsersSortInput: field: UsersSortField!, direction: UsersSortDirection!.

Nowe argumenty Query.users

Argument	Typ	Zastępuje	Uwagi
user_kind	UserKindFilterInput	kind	Filtruje według poszczególnych typów lub grup typów.
sort	[UsersSortInput!]	newest_first	Sortowanie według wielu pól.
status	[UserStatus!]	non_active	Domyślnie [ACTIVE, PENDING].
visibility	String	(nowy)	Dozwolone wartości są opisane w dokumentacji API. Nie przekazuj tego argumentu, dopóki Twoja integracja nie będzie dostosowana do udokumentowanych wartości.

Przestarzałe argumenty Query.users (wersja 2026-07)

Argumenty kind, newest_first i non_active są przestarzałe w Query.users od wersji 2026-07 i w schemacie oznaczone jako @deprecated. Nadal działają w czasie wykonywania w wersjach 2026-07 i 2026-10, ale klienci, którzy wykonują introspekcję z includeDeprecated: true, zobaczą poniższe powody oznaczenia ich jako przestarzałe:

Argument	Powód oznaczenia jako przestarzały
kind	Zamiast niego użyj user_kind.
newest_first	Zamiast niego użyj sort.
non_active	Zamiast niego użyj status.

Zaktualizuj integracje i konfigurację generowania kodu, aby korzystały z nowych argumentów powyżej. Nie ogłoszono wersji, w której zostaną usunięte. Śledź informacje o wersji API, z której korzysta Twoja integracja.

Nowe zapytanie

user_configs(kinds: [String], visibility: String): [UserConfig!]!

Zwraca konfiguracje użytkowników na koncie, posortowane rosnąco według role_id. Wymaga uprawnienia users:read i odpowiedniej autoryzacji.

Paginacja w Query.users (zmiana niezgodna wstecz)

Sytuacja	Przed wersją 2026-07	Wersja 2026-07 i nowsze
Brak limit	Zwracani są wszyscy pasujący użytkownicy	Zwracanych jest 200 użytkowników
Maksymalna wartość limit	Bez limitu	1000 (większe wartości powodują błąd)

Integracje, które nie przekazywały argumentu limit, mogą zwrócić mniej wyników. Użyj limit razem z page (i w razie potrzeby sort), aby jawnie stronicować wyniki.

Wymóg niepustości argumentu Query.users(emails: …)

W wersji 2026-07 typ argumentu zmienia się z [String] na [String!]. Nie przekazuj wartości null w tablicy emails.

---

Planowane zmiany w wersji 2026-10

Usunięcie poniższych pól typu User jest planowane w wersji 2026-10 (sprawdź schemat za pomocą introspekcji lub zapoznaj się z informacjami o wersji, której używasz):

• Zdjęcia: photo_original, photo_thumb, photo_thumb_small, photo_tiny, photo_small
• Flagi typu użytkownika: is_guest, is_admin, is_view_only
• Flagi statusu: is_pending, enabled
• Inne: is_verified, join_date, encrypt_api_token, sign_up_product_kind

W niektórych wersjach testowych te pola mogą nadal pojawiać się w wyniku introspekcji lub zwracać dane, dopóki ich usuwanie nie zostanie w pełni wdrożone. Nie opieraj na nich nowych rozwiązań - zamiast nich użyj poniższych zamienników.

---

Przestarzałe pola i ich zamienniki

Przestarzałe pole typu User	Zamiennik
photo_original	photo_url.original
photo_small	photo_url.small
photo_thumb	photo_url.thumb
photo_thumb_small	photo_url.thumb_small
photo_tiny	photo_url.tiny
is_guest	kind == "guest"
is_admin	kind == "admin"
is_view_only	kind == "view_only"
is_pending	status == PENDING
enabled	status == ACTIVE (lub != INACTIVE, jeśli jest to właściwe)
is_verified	is_email_confirmed
join_date	became_active_at
encrypt_api_token	Usunięte - brak zamiennika.
sign_up_product_kind	Usunięte - brak zamiennika.

Przestarzały argument Query.users	Zamiennik
kind: UserKind	user_kind: UserKindFilterInput
newest_first: Boolean	sort: [UsersSortInput!]
non_active: Boolean	status: [UserStatus!]

---

Więcej informacji

• Dokumentacja API monday.com - informacje o wersjonowaniu, uwierzytelnianiu oraz typach User, Query.users i powiązanych typach.
• Informacje o wersjach API i changelog w witrynie dla deweloperów - znajdziesz w nich szczegółowe informacje o działaniu konkretnej wersji API-Version, z której korzystasz.