The monday.com boards APIs enable you to create, read, update, and delete boards.

The types below are used by the boards queries and mutations, and are not independently queryable.

ItemNicknameInput

An object containing the item nickname.

Field	Type	Description
plural	`String`	The plural form of the item nickname
preset_type	`String`	The preset type for item nickname.
singular	`String`	The singular form of the item nickname.

item_nickname

🚧
Only available in version 2026-04 and later

An enum value of board_attribute on update_board that allows you to modify a board’s item nickname.

mutation {
  update_board(
    board_id: 1234567890
    board_attribute: item_nickname
    new_value: "{\"preset_type\":\"other\",\"singular\":\"Task\",\"plural\":\"Tasks\"}"
  )
}

Field	Type	Description
plural	`String`	The plural form of the item nickname
preset_type	`String`	The preset type for item nickname.
singular	`String`	The singular form of the item nickname.

SetBoardPermissionResponse

An object containing the result of setting a board's permissions via the API.

Field	Type	Description	Enum Values
edit_permissions	`BoardEditPermissions!`	Specifies which group of users is allowed to edit the board’s content. This setting reflects the board's technical editing permissions.	`assignee` `collaborators` `everyone` `owners`
failed_actions	`[String!]`	Any actions that failed during the permission update process.

UpdateBoardHierarchyAttributesInput

An object containing the board's attributes to update.

Field	Type	Description
account_product_id	`ID`	The board's updated account product ID. You must also provide the relevant `workspace_id` within the updated product.
folder_id	`ID`	The board's updated folder ID.
position	`DynamicPosition`	The board's updated position in the left-side menu.
workspace_id	`ID`	The board's updated workspace ID.

Dynamic position

An object containing the board's updated position in the left-side menu of the platform.

Field

Type

Description

Enum Values

is_after

Boolean

Specifies where to position the target board relative to the reference object:

Set to true to place the target after the reference
Set to false to place the target before the reference

object_id

String!

The unique identifier of the reference object that the target board should be positioned relative to.

object_type

ObjectType!

The type of the reference object.

Board
Folder
Overview

UpdateBoardHierarchyResult

An object containing the result of updating a board's position, product, or workspace.

Field	Type	Description
board	`Board`	The updated board.
message	`String`	A message about the operation's result.
success	`Boolean!`	Whether the operation was successful.

BoardInferredMetadata

🚧
Only available in API versions 2026-07 and later

Optional metadata inferred for a board (for example, how items are referred to in context).

Field	Type	Description
item_type	`String`	Custom terminology label for items on this board (when set).

BoardManualMetadata

🚧
Only available in API versions 2026-07 and later

Optional metadata supplied explicitly for a board.

Field	Type	Description
board_md	`String`	Markdown content describing the board.