---

Tablice obszarów roboczych w monday.com służą zespołom do zarządzania kontami według działów, zespołów lub projektów. Zawierają tablice, pulpity i foldery, które pomagają zachować porządek.

Zapytania

Pobieranie obszarów roboczych

• Wymagany zakres: workspaces:read
• Zwraca tablicę zawierającą metadane jednego lub wielu obszarów roboczych.
• Można wykonać zapytanie bezpośrednio na poziomie głównym lub zagnieździć je w zapytaniu boards (zwraca identyfikator obszaru roboczego i wymaga tylko zakresu boards:read).

query {
  workspaces(ids: 1234567) {
    id
    name
    kind
    description
  }
}

Pobieranie głównego obszaru roboczego

Każde konto ma główny obszar roboczy, ale zwykle nie można pobrać jego szczegółów przez API.

Użytkownicy będą jednak mogli pobierać szczegóły głównego obszaru roboczego po zakończeniu migracji do obsługi wielu produktów, która potrwa kilka najbliższych miesięcy. Ta funkcja będzie udostępniana stopniowo, więc może jeszcze nie być dostępna na Twoim koncie. Po zakończeniu migracji będą z niej mogli korzystać wszyscy użytkownicy.

Poniżej opisano oczekiwane działanie przed migracją i po niej:

Przed migracją

Jeśli pobierzesz listę obszarów roboczych na swoim koncie, główny obszar roboczy nie pojawi się w wynikach, ponieważ ma identyfikator null lub -1. Możesz jednak filtrować tablice w głównym obszarze roboczym, przekazując null jako wartość workspace_id.

query {
  boards (workspace_ids: [null], limit:50) {
    name
  }
}

Po migracji

Jeśli pobierzesz listę obszarów roboczych na swoim koncie, główny obszar roboczy pojawi się w wynikach z prawidłowym identyfikatorem id. Możesz wtedy użyć tego identyfikatora, aby pobrać główny obszar roboczy.

Argumenty

Argument	Typ	Opis	Wartości wyliczeniowe
ids	[ID!]	Konkretne obszary robocze, które mają zostać zwrócone.
kind	WorkspaceKind	Rodzaj obszarów roboczych, które mają zostać zwrócone.	closed open template
limit	Int	Liczba obszarów roboczych, które mają zostać zwrócone. Domyślnie 25.
membership_kind	WorkspaceMembershipKind	Rodzaj członkostwa użytkownika w obszarze roboczym.	all (zwraca wszystkie obszary robocze widoczne dla użytkownika) member (zwraca tylko obszary robocze, których użytkownik jest członkiem)
order_by	WorkspacesOrderBy	Kolejność pobierania obszarów roboczych.	created_at
page	Int	Numer strony do pobrania. Numeracja zaczyna się od 1.
state	State	Stan obszarów roboczych, według którego mają być filtrowane. Domyślnie active.	active all archived deleted
query_params	WorkspacesQueryInput	Filtruje obszary robocze według rodzaju produktu na koncie. Dostępne tylko w wersji 2026-04 i nowszych.	account_product_kind: core crm forms marketing project_management service software whiteboard

Pola

Pola	Typ	Opis	Wartości wyliczeniowe
account_product	AccountProduct	Produkt na koncie, do którego należy obszar roboczy.
created_at	Date	Data utworzenia obszaru roboczego.
description	String	Opis obszaru roboczego.
id	ID	Unikalny identyfikator obszaru roboczego.
is_default_workspace	Boolean	Określa, czy obszar roboczy jest domyślnym obszarem roboczym produktu lub konta. Nie wszystkie konta mogą pobierać główny obszar roboczy (więcej informacji tutaj).
kind	WorkspaceKind	Rodzaj obszaru roboczego.	closed open template
name	String!	Nazwa obszaru roboczego.
owners_subscribers	[User]	Właściciele obszaru roboczego. Domyślnie 25. Wymaga zakresu users:read.
settings	WorkspaceSettings	Ustawienia obszaru roboczego.
state	State	Stan obszaru roboczego. Domyślnie active.	active all archived deleted
team_owners_subscribers	[Team!]	Zespoły będące właścicielami obszaru roboczego. Domyślnie 25. Wymaga zakresu teams:read.
teams_subscribers	[Team]	Zespoły obserwujące obszar roboczy. Domyślnie 25. Wymaga zakresu teams:read.
users_subscribers	[User]	Użytkownicy obserwujący obszar roboczy. Domyślnie 25. Wymaga zakresu users:read.

Mutacje

• Wymagany zakres: workspaces:write

Tworzenie obszaru roboczego

Tworzy nowy obszar roboczy. Zwraca Workspace.

mutation {
  create_workspace(
    name:"New Cool Workspace"
    kind: open
    description: "This is a cool description"
    account_product_id: 505616
    ) {
    id
    description
  }
}

Argumenty

Argumenty	Typ	Opis	Wartości wyliczeniowe
account_product_id	ID	Unikalny identyfikator produktu na koncie, w którym ma zostać utworzony nowy obszar roboczy.
description	String	Opis nowego obszaru roboczego.
kind	WorkspaceKind!	Rodzaj nowego obszaru roboczego.	closed open
name	String!	Nazwa nowego obszaru roboczego.

Aktualizowanie obszaru roboczego

Aktualizuje obszar roboczy. Zwraca Workspace.

mutation {
  update_workspace(
    id: 1234567
    attributes: {
      account_product_id: 98765
      name:"Marketing team"
      description: "This workspace is for the marketing team." 
    }
    ) {
    id
  }
}

Argumenty

Argumenty	Typ	Opis
attributes	UpdateWorkspaceAttributesInput!	Atrybuty obszaru roboczego do zaktualizowania.
id	ID	Unikalny identyfikator obszaru roboczego.

Dodawanie zespołów do obszaru roboczego

Dodaje zespoły do obszaru roboczego. Zwraca [Team].

mutation {
  add_teams_to_workspace(
    workspace_id: 1234567
    team_ids: [
      12345678
      87654321
      56789012
    ]
    ) {
    id
  }
}

Argumenty

Argumenty	Typ	Opis	Wartości wyliczeniowe
kind	WorkspaceSubscriberKind	Rodzaj obserwującego.	owner subscriber
team_ids	[ID!]!	Unikalne identyfikatory zespołów.
workspace_id	ID!	Unikalny identyfikator obszaru roboczego.

Dodawanie użytkowników do obszaru roboczego

Dodaje użytkowników do obszaru roboczego. Zwraca [User].

mutation {
  add_users_to_workspace(
    workspace_id: 1234567
    user_ids: [
      12345678
      87654321
      56789012
    ]
    kind: subscriber
    ) {
    id
  }
}

Argumenty

Argumenty	Typ	Opis	Wartości wyliczeniowe
kind	WorkspaceSubscriberKind	Rodzaj obserwującego.	owner subscriber
user_ids	[ID!]!	Unikalne identyfikatory użytkowników.
workspace_id	ID!	Unikalny identyfikator obszaru roboczego.

Usuwanie obszaru roboczego

Usuwa obszar roboczy. Zwraca Workspace.

mutation {
  delete_workspace(workspace_id: 1234567) {
    id
  }
}

Argumenty

Argumenty	Typ	Opis
workspace_id	ID!	Unikalny identyfikator obszaru roboczego.

Usuwanie zespołów z obszaru roboczego

Usuwa zespoły z obszaru roboczego. Zwraca [Team].

mutation {
  delete_teams_from_workspace(
    workspace_id: 1234567
    team_ids: [
      12345678
      87654321
      56789012
    ]
    ) {
    id
  }
}

Argumenty

Argumenty	Typ	Opis
team_ids	[ID!]!	Unikalne identyfikatory zespołów.
workspace_id	ID!	Unikalny identyfikator obszaru roboczego.

Usuwanie użytkowników z obszaru roboczego

Usuwa użytkowników z obszaru roboczego. Zwraca [User].

mutation {
  delete_users_from_workspace(
    workspace_id: 1234567
    user_ids: [
      12345678
      87654321
      56789012
    ]
    ) {
    id
  }
}

Argumenty

Argumenty	Typ	Opis
user_ids	[ID!]!	Unikalne identyfikatory użytkowników.
workspace_id	ID!	Unikalny identyfikator obszaru roboczego.