Users can create folders inside their workspaces to help organize their boards, dashboards, and workdocs.

Queries

Required scope: workspaces:read

Returns an array containing metadata about one or a collection of folders
Can only be queried directly at the root

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

let query = "query { folders (workspace_ids: 1234567890) { name id children { id name }}}";

fetch ("https://api.monday.com/v2", {
  method: 'post',
  headers: {
    'Content-Type': 'application/json',
    'Authorization' : 'YOUR_API_KEY_HERE'
   },
   body: JSON.stringify({
     query : query
   })
  })
   .then(res => res.json())
   .then(res => console.log(JSON.stringify(res, null, 2)));

Arguments

You can use the following argument(s) to reduce the number of results returned in your folders query.

Argument	Description
ids `[ID!]`	The specific folders to return.
limit `Int`	The number of folders to get. The default is 25 and the maximum is 100.
page `Int`	The page number to return. Starts at 1.
workspace_ids `[ID]`	The unique identifiers of the specific workspaces to return. You can pass `[null]` to return folders in the Main Workspace.

Fields

You can use the following field(s) to specify what information your folders query will return.

Field	Description
children `[Board]!`	The folder's contents, excluding dashboards and subfolders.
color `FolderColor`	The folder's color. See a full list of colors here.
created_at `Date!`	The folder's creation date.
id `ID!`	The folder's unique identifier.
name `String!`	The folder's name.
owner_id `ID`	The unique identifier of the folder's owner.
parent `Folder`	The folder's parent folder.
sub_folders `[Folder]!`	The folders inside of the parent folder.
workspace `Workspace!`	The workspace that contains the folder.

Mutations

Required scope: workspaces:write

Create a folder

The create_folder mutation allows you to create a new folder in a workspace. You can also specify what fields to query back from the new folder when you run the mutation.

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

let query = "mutation { create_folder (name: \"New folder\" , workspace_id: 1234567890) { id }}";

fetch ("https://api.monday.com/v2", {
  method: 'post',
  headers: {
    'Content-Type': 'application/json',
    'Authorization' : 'YOUR_API_KEY_HERE'
   },
   body: JSON.stringify({
     query : query
   })
  })
   .then(res => res.json())
   .then(res => console.log(JSON.stringify(res, null, 2)));

Arguments

You can use the following arguments to define the new folder's characteristics.

Argument	Description
color `FolderColor`	The folder's color. See a full list of colors here.
name `String!`	The folder's name.
parent_folder_id `ID`	The ID of the folder you want to nest the new one under.
workspace_id `ID`	The unique identifier of the workspace to create the new folder in.

Update a folder

The update_folder mutation allows you to update a folder's color, name, or parent folder. You can also specify what fields to query back from the updated folder when you run the mutation.

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
  }
}

Arguments

You can use the following arguments to define the updated folder's characteristics.

Argument	Description	Enum values	Supported fields
account_product_id `ID`	The unique identifier of the product to move the folder to. You must also provide the relevant `workspace_id` within the updated product.This argument is only available in API versions `2025-10` and later.
color `FolderColor`	The folder's color. See a full list of colors here.
custom_icon `FolderCustomIcon`	The folder's custom icon. See a full list of icons here .
folder_id `ID!`	The folder's unique identifier.
font_weight `FolderFontWeight`	The folder's font weight.	`FONT_WEIGHT_BOLD` `FONT_WEIGHT_LIGHT` `FONT_WEIGHT_NORMAL` `FONT_WEIGHT_VERY_LIGHT` `NULL`
name `String`	The folder's name.
parent_folder_id `ID`	The ID of the folder you want to nest the updated one under.
position `DynamicPosition`	The folder's updated position in the left-side menu. This argument is only available in API versions `2025-10` and later.		is_after `Boolean` object_id `String!` object_type `ObjectType!`
workspace_id `ID`	The unique identifier of the workspace to move the folder to. This argument is only available in API versions `2025-10` and later.

Delete a folder

The delete_folder mutation allows you to delete and folder and all its contents. You can also specify what fields to query back from the deleted folder when you run the mutation.

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

let query = "mutation { delete_folder (folder_id: 1234567890) { id }}";

fetch ("https://api.monday.com/v2", {
  method: 'post',
  headers: {
    'Content-Type': 'application/json',
    'Authorization' : 'YOUR_API_KEY_HERE'
   },
   body: JSON.stringify({
     query : query
   })
  })
   .then(res => res.json())
   .then(res => console.log(JSON.stringify(res, null, 2)));

Arguments

You can use the following arguments to specify which folder to delete.

Argument	Description
folder_id `ID!`	The folder's unique identifier.