Użytkownicy mogą tworzyć foldery w obszarach roboczych, aby porządkować tablice, pulpity i WorkDocs.

Zapytania

Pobieranie folderów

• Wymagany zakres:workspaces:read
• Zwraca tablicę zawierającą metadane jednego folderu lub kolekcji folderów.
• Można je wykonywać bezpośrednio tylko na poziomie głównym - nie można zagnieżdżać ich w innym zapytaniu.

query {
  folders(workspace_ids: [1234567890]) {
    id
    name
    children {
      id
      name
    }
  }
}

Argumenty

Argument	Typ	Opis
ids	[ID!]	Konkretne foldery do zwrócenia.
limit	Int	Liczba folderów do pobrania. Domyślnie 25, maksymalnie 100.
page	Int	Numer strony do zwrócenia. Numeracja zaczyna się od 1.
workspace_ids	[ID]	Unikalne identyfikatory obszarów roboczych do zwrócenia. Możesz przekazać [null], aby zwrócić foldery w głównym obszarze roboczym (Main Workspace).

Pola

Pole	Typ	Opis
children	[Board]!	Zawartość folderu, bez pulpitów i podfolderów.
color	FolderColor	Kolor folderu. Pełną listę kolorów znajdziesz tutaj.
created_at	Date!	Data utworzenia folderu.
id	ID!	Unikalny identyfikator folderu.
name	String!	Nazwa folderu.
owner_id	ID	Unikalny identyfikator właściciela folderu.
parent	Folder	Folder nadrzędny.
sub_folders	[Folder]!	Foldery znajdujące się w folderze nadrzędnym.
workspace	Workspace!	Obszar roboczy zawierający folder.
app_feature_slug	String	Identyfikator funkcji aplikacji powiązanej z tym folderem (Folders 2.0). Dostępne tylko w wersji 2026-04 i nowszych.

Mutacje

Wymagany zakres:workspaces:write

Tworzenie folderu

Tworzy nowy folder w obszarze roboczym. Zwraca Folder.

mutation {
  create_folder(
    name: "New folder", 
    workspace_id: 1234567890
    ) {
    id
  }
}

Argumenty

Argument	Typ	Opis
color	FolderColor	Kolor folderu. Pełną listę kolorów znajdziesz tutaj.
name	String!	Nazwa folderu.
parent_folder_id	ID	Identyfikator folderu, w którym chcesz umieścić nowy folder.
workspace_id	ID	Unikalny identyfikator obszaru roboczego, w którym ma zostać utworzony nowy folder.

Aktualizowanie folderu

Aktualizuje kolor, nazwę lub folder nadrzędny. Zwraca Folder.

mutation {
  update_folder(
    folder_id: 1234567890,
    name: "Updated folder name",
    account_product_id: 54321,
    position: {
      object_id: "15",
      object_type: Board,
      is_after: false
    }
  ) {
    id
    name
  }
}

Argumenty

Argument	Typ	Opis	Wartości wyliczeniowe
account_product_id	ID	Unikalny identyfikator produktu, do którego chcesz przenieść folder. Musisz też podać odpowiedni workspace_id w zaktualizowanym produkcie.
color	FolderColor	Kolor folderu. Pełną listę kolorów znajdziesz tutaj.
custom_icon	FolderCustomIcon	Niestandardowa ikona folderu. Pełną listę ikon znajdziesz tutaj.
folder_id	ID!	Unikalny identyfikator folderu.
font_weight	FolderFontWeight	Grubość czcionki folderu.	FONT_WEIGHT_BOLD FONT_WEIGHT_LIGHT FONT_WEIGHT_NORMAL FONT_WEIGHT_VERY_LIGHT NULL
name	String	Nazwa folderu.
parent_folder_id	ID	Identyfikator folderu, w którym chcesz umieścić zaktualizowany folder.
position	DynamicPosition	Nowa pozycja folderu w menu po lewej stronie.
workspace_id	ID	Unikalny identyfikator obszaru roboczego, do którego chcesz przenieść folder.

Usuwanie folderu

Usuwa folder i całą jego zawartość. Zwraca Folder.

mutation {
  delete_folder(
    folder_id: 1234567890
    ) {
    id
  }
}

Argumenty

Argument	Typ	Opis
folder_id	ID!	Unikalny identyfikator folderu.