Nowe zgłoszenie

Dokumentacja dla programistów›Dokumentacja API (rdzeń)›Inne typy

Dokumentacja dla programistów

Inne typy

Dokumentacja API (rdzeń)Dokumentacja API

Aktualizacja 2026-09-17

Interfejsy API monday.com użytkowników umożliwiają tworzenie, odczytywanie, aktualizowanie i usuwanie użytkowników.

Poniższe typy są używane przez zapytania i mutacje dotyczące użytkowników. Nie można ich odpytywać niezależnie.

InvitationMethod

Dostępne tylko w wersji API 2026-07 i nowszych

Metoda, za pomocą której użytkownik został dodany do konta. Zwracana w polu User.invitation_method.

Wartość wyliczenia	Opis
`USER`	Zaproszony przez innego użytkownika.
`SCIM`	Dodany za pomocą SCIM.
`SSO`	Dodany za pomocą logowania jednokrotnego.
`AUTH_DOMAIN`	Dodany za pomocą autoryzowanej domeny.
`FIRST_USER`	Pierwszy użytkownik, który utworzył konto.
`CONSOLIDATION`	Dodany podczas konsolidacji kont.
`INTERNAL_CREATION`	Utworzony w ramach wewnętrznego procesu monday.com.
`UNKNOWN`	Nieznana metoda zaproszenia.
`SERVICE_PORTAL_AUTH_DOMAIN`	Dodany za pomocą autoryzowanej domeny portalu usług.
`SERVICE_PORTAL_USER_INVITATION`	Zaproszony do portalu monday service przez innego użytkownika.
`API_USER_CREATION`	Utworzony jako użytkownik API.

PhotoUrl

Dostępne tylko w wersji API 2026-07 i nowszych

Adresy URL zdjęcia profilowego użytkownika w każdym obsługiwanym rozmiarze. Zwracane w polu User.photo_url. Zastępują płaskie pola photo_*.

Pole	Opis	Uwagi
original `String`	Adres URL zdjęcia w pierwotnym rozmiarze, w którym zostało przesłane.	Wymaga autoryzacji.
small `String`	Adres URL zdjęcia w rozmiarze 150×150 px.
thumb `String`	Adres URL zdjęcia w rozmiarze 100×100 px.
thumb_small `String`	Adres URL zdjęcia w rozmiarze 50×50 px.
tiny `String`	Adres URL zdjęcia w rozmiarze 30×30 px.

UserConfig

Dostępne tylko w wersji API 2026-07 i nowszych

Konfiguracja użytkownika na koncie, zależna od rodzaju użytkownika. Dostępna przez User.user_config (pojedyncza konfiguracja użytkownika) lub user_configs (wszystkie konfiguracje zdefiniowane na koncie). Wymaga zakresu users:read.

Pole	Opis
kind `String!`	Rodzaj użytkownika, którego dotyczy ta konfiguracja, na przykład `admin`, `member`, `guest` lub `view_only`.
role_id `ID!`	Identyfikator roli powiązanej z tą konfiguracją.
visibility `[String!]!`	Ustawienia widoczności tej konfiguracji.

UserKindFilter

Dostępne tylko w wersji API 2026-07 i nowszych

Używany wewnątrz UserKindFilterInput jako argument user_kind zapytania Query.users. Obsługuje zarówno poszczególne rodzaje użytkowników, jak i ich grupy.

Wartość wyliczenia	Opis
`ADMIN`	Użytkownik z uprawnieniami administratora.
`MEMBER`	Członek zespołu.
`GUEST`	Gość.
`VIEW_ONLY`	Użytkownik z dostępem tylko do wyświetlania.
`AGENT_MEMBER`	Członek zespołu pełniący rolę agenta.
`PORTAL`	Zewnętrzny użytkownik portalu.
`BASIC`	Grupa: administratorzy, członkowie zespołu, goście i użytkownicy z dostępem tylko do wyświetlania.
`PORTFOLIO_API_USER`	Użytkownik API funkcji Portfolio.
`NEXUS_API_USER`	Użytkownik API funkcji Nexus.
`RESOURCE_DIRECTORY_API_USER`	Użytkownik API funkcji Resource Directory.
`OMNICHANNEL_API_USER`	Użytkownik API funkcji Omnichannel.
`GOALS_API_USER`	Użytkownik API funkcji Goals.
`PROJECTS_API_USER`	Użytkownik API funkcji Projects.
`SPRINT_MANAGEMENT_API_USER`	Użytkownik API funkcji Sprint Management.
`CRM_COMMERCE_API_USER`	Użytkownik API funkcji CRM Commerce.
`CAMPAIGNS_API_USER`	Użytkownik API funkcji Campaigns.
`DATA_RETENTION_API_USER`	Użytkownik API funkcji Data Retention.
`MONDAY_SERVICE_API_USER`	Użytkownik API funkcji monday service.
`AI_PLATFORM_AGENT_API_USER`	Użytkownik API funkcji AI Platform Agent.
`DEPENDENCIES_API_USER`	Użytkownik API funkcji Dependencies.
`HISTORICAL_TRACKING_BACKFILL_API_USER`	Użytkownik API funkcji uzupełniania danych historycznego śledzenia.
`CRM_USER_AGENT_MEMBER`	Użytkownik CRM pełniący rolę członka zespołu-agenta. Dostępne tylko w wersji `2026-10` i nowszych.

UserKindFilterInput

Dostępne tylko w wersji API 2026-07 i nowszych

Używany jako argument user_kind w Query.users. Wartości not_in są usuwane z rozwiniętego zestawu in.

Pole	Opis
in `[UserKindFilter!]`	Uwzględnij użytkowników pasujących do dowolnego z tych rodzajów lub grup rodzajów.
not_in `[UserKindFilter!]`	Wyklucz użytkowników pasujących do tych rodzajów lub grup rodzajów.

UserStatus

Dostępne tylko w wersji API 2026-07 i nowszych

Status aktywacji użytkownika. Zwracany w polu User.status i akceptowany jako argument status zapytania Query.users.

Wartość wyliczenia	Opis
`ACTIVE`	Użytkownik jest aktywny.
`INACTIVE`	Użytkownik został dezaktywowany.
`PENDING`	Użytkownik nie zaakceptował jeszcze zaproszenia.

UsersSortField

Dostępne tylko w wersji API 2026-07 i nowszych

Pole używane wewnątrz UsersSortInput do sortowania wyników zapytania Query.users.

Wartość wyliczenia	Opis
`CREATED_AT`	Sortuj według daty utworzenia użytkownika.

UsersSortDirection

Dostępne tylko w wersji API 2026-07 i nowszych

Kierunek sortowania używany wewnątrz UsersSortInput.

Wartość wyliczenia	Opis
`ASC`	Sortuj rosnąco.
`DESC`	Sortuj malejąco.

UsersSortInput

Dostępne tylko w wersji API 2026-07 i nowszych

Używany jako argument sort w zapytaniu Query.users. Zastępuje starszą wartość logiczną newest_first.

Pole	Opis
field `UsersSortField!`	Pole, według którego należy sortować.
direction `UsersSortDirection!`	Kierunek sortowania.

ActivateUsersResult

Obiekt zawierający wynik aktywowania użytkowników za pomocą API.

Pole	Typ	Opis	Obsługiwane pola
activated_users	`[User!]`	Użytkownicy, którzy zostali aktywowani.
errors	`[ActivateUsersError!]`	Błędy, które wystąpiły podczas aktywowania użytkowników. Użyj tego pola, aby sprawdzić, które wywołania zakończyły się niepowodzeniem.	code `ActivateUsersErrorCode` message `String` user_id `ID`

ActivateUsersError

Obiekt zawierający błąd, który wystąpił, gdy mutacja activate_users zakończyła się niepowodzeniem.

Pole	Typ	Opis	Wartości wyliczenia
code	`ActivateUsersErrorCode`	Kod błędu, który wystąpił.	`CANNOT_UPDATE_SELF` `EXCEEDS_BATCH_LIMIT` `FAILED` `INVALID_INPUT` `USER_NOT_FOUND`
message	`String`	Komunikat o błędzie.
user_id	`ID`	Unikalny identyfikator użytkownika, którego dotyczy błąd.

ClearUsersDepartmentResult

Dostępne tylko w wersji API 2026-04 i nowszych

Obiekt zawierający wynik dezaktywowania użytkowników za pomocą API.

Pole	Typ	Opis
cleared_users	`[User]!`	Dane użytkowników, których działy zostały wyczyszczone.

DeactivateUsersResult

Obiekt zawierający wynik dezaktywowania użytkowników za pomocą API.

Pole	Typ	Opis
deactivated_users	`[User]!`	Dane użytkowników, którzy zostali dezaktywowani.
errors	`[DeactivateUsersError]!`	Błędy, które wystąpiły podczas dezaktywowania. Użyj tego pola, aby sprawdzić, które wywołania zakończyły się niepowodzeniem.

DeactivateUsersError

Obiekt zawierający błąd, który wystąpił, gdy mutacja deactivate_users zakończyła się niepowodzeniem.

Pole	Opis	Wartości wyliczenia
code `DeactivateUsersErrorCode`	Kod błędu, który wystąpił.	`CANNOT_UPDATE_SELF` `EXCEEDS_BATCH_LIMIT` `FAILED` `INVALID_INPUT` `USER_NOT_FOUND`
message `String`	Komunikat o błędzie.
user_id `ID`	Unikalny identyfikator użytkownika, którego dotyczy błąd.

InviteUsersResult

Obiekt zawierający wynik zapraszania użytkowników za pomocą API.

Pole	Typ	Opis
invited_users	`[User!]`	Dane użytkowników, którzy zostali pomyślnie zaproszeni.
errors	`[InviteUsersError!]`	Błędy, które wystąpiły podczas zapraszania. Użyj tego pola, aby sprawdzić, które wywołania zakończyły się niepowodzeniem.

InviteUsersError

Obiekt zawierający błąd, który wystąpił, gdy mutacja invite_users zakończyła się niepowodzeniem.

Pole	Typ	Opis	Wartości wyliczenia
code	`InviteUsersErrorCode`	Kod błędu, który wystąpił.	`ERROR`
message	`String`	Komunikat o błędzie.
email	`ID`	Adres e-mail użytkownika, którego dotyczy błąd.

UpdateEmailDomainAttributesInput

Obiekt zawierający atrybuty do zaktualizowania.

Pole	Typ	Opis
new_domain	`String!`	Zaktualizowana domena e-mail.
user_ids	`[ID!]!`	Unikalne identyfikatory użytkowników do zaktualizowania. Maksymalna liczba to 200.

UpdateUserAttributesResult

Obiekt zawierający wynik aktualizowania atrybutów użytkowników za pomocą API.

Pole	Typ	Opis
errors	`[UpdateUserAttributesError!]`	Błędy, które wystąpiły podczas aktualizowania atrybutów użytkowników. Użyj tego pola, aby sprawdzić, które wywołania zakończyły się niepowodzeniem.
updated_users	`[User!]`	Dane użytkowników, których atrybuty zostały zaktualizowane.

UpdateUserAttributesError

Obiekt zawierający błąd, który wystąpił, gdy mutacja update_multiple_users zakończyła się niepowodzeniem.

Pole	Typ	Opis	Wartości wyliczenia
code	`UpdateUserAttributesErrorCode`	Kod błędu.	`INVALID_FIELD`
message	`String`	Komunikat o błędzie.
user_id	`ID`	Unikalny identyfikator użytkownika, którego dotyczy błąd.

UpdateEmailDomainAttributesInput

Obiekt zawierający atrybuty do zaktualizowania za pomocą mutacji update_email_domain.

Pole	Typ	Opis
new_domain	`String!`	Zaktualizowana domena e-mail.
user_ids	`[ID!]!`	Unikalne identyfikatory użytkowników do zaktualizowania. Maksymalna liczba to 200.

UpdateUsersEmailDomainResult

Obiekt zawierający wynik aktualizowania domeny e-mail użytkownika za pomocą API.

Pole	Typ	Opis
errors	`[UpdateEmailDomainError!]`	Błędy, które wystąpiły podczas aktualizowania domeny e-mail. Użyj tego pola, aby sprawdzić, które wywołania zakończyły się niepowodzeniem.
updated_users	`[User!]`	Dane użytkowników, których domeny e-mail zostały zaktualizowane.

UpdateEmailDomainError

Obiekt zawierający błąd, który wystąpił, gdy mutacja update_email_domain zakończyła się niepowodzeniem.

Pole	Typ	Opis	Wartości wyliczenia
code	`UpdateEmailDomainErrorCode`	Kod błędu, który wystąpił.	`CANNOT_UPDATE_SELF` `EXCEEDS_BATCH_LIMIT` `FAILED` `INVALID_INPUT` `UPDATE_EMAIL_DOMAIN_ERROR` `USER_NOT_FOUND`
message	`String`	Komunikat o błędzie.
user_id	`ID`	Unikalny identyfikator użytkownika, którego dotyczy błąd.

UpdateUsersRoleResult

Obiekt zawierający wynik aktualizowania roli użytkownika za pomocą API.

Pole	Typ	Opis
errors	`[UpdateUsersRoleError!]`	Błędy, które wystąpiły podczas aktualizowania roli. Użyj tego pola, aby sprawdzić, które wywołania zakończyły się niepowodzeniem.
updated_users	`[User]!`	Dane użytkowników, których role zostały zaktualizowane.

UpdateUsersRoleError

Obiekt zawierający błąd, który wystąpił, gdy mutacja update_users_role zakończyła się niepowodzeniem.

Pole	Typ	Opis	Wartości wyliczenia
code	`UpdateUsersRoleErrorCode`	Kod błędu, który wystąpił.	`CANNOT_UPDATE_SELF` `EXCEEDS_BATCH_LIMIT` `FAILED` `INVALID_INPUT` `USER_NOT_FOUND`
message	`String`	Komunikat o błędzie.
user_id	`ID`	Unikalny identyfikator użytkownika, którego dotyczy błąd.

UserUpdateInput

Obiekt zawierający identyfikatory użytkowników i atrybuty do zaktualizowania.

Pole	Typ	Opis
user_attribute_updates	`UserAttributesInput!`	Atrybuty do zaktualizowania.
user_id	`ID!`	Unikalny identyfikator użytkownika do zaktualizowania.

UserAttributesInput

Obiekt zawierający określone atrybuty do zaktualizowania.

Pole	Typ	Opis
birthday	`String`	Zaktualizowana data urodzenia użytkownika. Użyj formatu YYYY-MM-DD.
department	`String`	Zaktualizowany dział użytkownika.
email	`String`	Zaktualizowany adres e-mail użytkownika.
join_date	`String`	Zaktualizowana data dołączenia użytkownika. Użyj formatu YYYY-MM-DD.
location	`String`	Zaktualizowana lokalizacja użytkownika.
mobile_phone	`String`	Zaktualizowany numer telefonu komórkowego użytkownika.
name	`String`	Zaktualizowane imię i nazwisko użytkownika.
phone	`String`	Zaktualizowany numer telefonu użytkownika.
title	`String`	Zaktualizowane stanowisko użytkownika.

Mam problem z tym tematem Źródło: developer.monday.com