MondayClient
Attributes
TRIGGER_OPERATIONS
module-attribute
TRIGGER_OPERATIONS: Dict[str, Dict[str, Any]] = {'WebhookCreateItem': {'operation_id': 'WebhookCreateItem', 'path': '/{connectionId}/registerWebhook/CreateItem', 'method': 'post', 'required_parameters': ['body'], 'callback_payload_type': 'WebhookCreateItemResponse'}, 'WebhookCreateUpdate': {'operation_id': 'WebhookCreateUpdate', 'path': '/{connectionId}/registerWebhook/CreateUpdate', 'method': 'post', 'required_parameters': ['body'], 'callback_payload_type': 'WebhookCreateUpdateResponse'}, 'WebhookChangeName': {'operation_id': 'WebhookChangeName', 'path': '/{connectionId}/registerWebhook/ChangeName', 'method': 'post', 'required_parameters': ['body'], 'callback_payload_type': 'WebhookChangeNameResponse'}, 'WebhookChangeSubitemName': {'operation_id': 'WebhookChangeSubitemName', 'path': '/{connectionId}/registerWebhook/ChangeSubitemName', 'method': 'post', 'required_parameters': ['body'], 'callback_payload_type': 'WebhookChangeSubitemNameResponse'}, 'WebhookCreateSubitem': {'operation_id': 'WebhookCreateSubitem', 'path': '/{connectionId}/registerWebhook/CreateSubitem', 'method': 'post', 'required_parameters': ['body'], 'callback_payload_type': 'WebhookCreateSubitemResponse'}, 'WebhookColumnChanges': {'operation_id': 'WebhookColumnChanges', 'path': '/{connectionId}/registerWebhook/ColumnChanges', 'method': 'post', 'required_parameters': ['body'], 'callback_payload_type': 'WebhookColumnChangesResponse'}, 'WebhookAnyColumnChanges': {'operation_id': 'WebhookAnyColumnChanges', 'path': '/{connectionId}/registerWebhook/AnyColumnChanges', 'method': 'post', 'required_parameters': ['body'], 'callback_payload_type': 'WebhookAnyColumnChangesResponse'}, 'WebhookSubitemColumnChanges': {'operation_id': 'WebhookSubitemColumnChanges', 'path': '/{connectionId}/registerWebhook/SubitemColumnChanges', 'method': 'post', 'required_parameters': ['body'], 'callback_payload_type': 'WebhookSubitemColumnChangesResponse'}}
Classes
WebhookCreateItemInput
dataclass
WebhookCreateItemInput(workspace_id: Optional[str] = None, board_id: Optional[str] = None, callback_url: Optional[str] = None)
When an item is created
Attributes
workspace_id
class-attribute
instance-attribute
Select a workspace from the drop-down or specify a workspace ID.
board_id
class-attribute
instance-attribute
Select a board from the drop-down or specify a board ID.
WebhookCreateItemResponse
dataclass
WebhookCreateUpdateInput
dataclass
WebhookCreateUpdateInput(workspace_id: Optional[str] = None, board_id: Optional[str] = None, callback_url: Optional[str] = None)
When a new update is posted
Attributes
workspace_id
class-attribute
instance-attribute
Select a workspace from the drop-down or specify a workspace ID.
board_id
class-attribute
instance-attribute
Select a board from the drop-down or specify a board ID.
WebhookCreateUpdateResponse
dataclass
WebhookChangeNameInput
dataclass
WebhookChangeNameInput(workspace_id: Optional[str] = None, board_id: Optional[str] = None, callback_url: Optional[str] = None)
When an item's name changes
Attributes
workspace_id
class-attribute
instance-attribute
Select a workspace from the drop-down or specify a workspace ID.
board_id
class-attribute
instance-attribute
Select a board from the drop-down or specify a board ID.
WebhookChangeNameResponse
dataclass
WebhookChangeSubitemNameInput
dataclass
WebhookChangeSubitemNameInput(workspace_id: Optional[str] = None, board_id: Optional[str] = None, callback_url: Optional[str] = None)
When a subitem's name changes
Attributes
workspace_id
class-attribute
instance-attribute
Select a workspace from the drop-down or specify a workspace ID.
board_id
class-attribute
instance-attribute
Select a board from the drop-down or specify a board ID.
WebhookChangeSubitemNameResponse
dataclass
WebhookCreateSubitemInput
dataclass
WebhookCreateSubitemInput(workspace_id: Optional[str] = None, board_id: Optional[str] = None, callback_url: Optional[str] = None)
When a subitem is created
Attributes
workspace_id
class-attribute
instance-attribute
Select a workspace from the drop-down or specify a workspace ID.
board_id
class-attribute
instance-attribute
Select a board from the drop-down or specify a board ID.
WebhookCreateSubitemResponse
dataclass
WebhookColumnChangesInput
dataclass
WebhookColumnChangesInput(workspace_id: Optional[str] = None, board_id: Optional[str] = None, column_id: Optional[str] = None, callback_url: Optional[str] = None)
When a column changes
Attributes
workspace_id
class-attribute
instance-attribute
Select a workspace from the drop-down or specify a workspace ID.
board_id
class-attribute
instance-attribute
Select a board from the drop-down or specify a board ID.
column_id
class-attribute
instance-attribute
Select a column from the drop-down.
WebhookColumnChangesResponse
dataclass
WebhookAnyColumnChangesInput
dataclass
WebhookAnyColumnChangesInput(workspace_id: Optional[str] = None, board_id: Optional[str] = None, callback_url: Optional[str] = None)
When any column changes
Attributes
workspace_id
class-attribute
instance-attribute
Select a workspace from the drop-down or specify a workspace ID.
board_id
class-attribute
instance-attribute
Select a board from the drop-down or specify a board ID.
WebhookAnyColumnChangesResponse
dataclass
WebhookSubitemColumnChangesInput
dataclass
WebhookSubitemColumnChangesInput(workspace_id: Optional[str] = None, board_id: Optional[str] = None, callback_url: Optional[str] = None)
When any subitem column changes
Attributes
workspace_id
class-attribute
instance-attribute
Select a workspace from the drop-down or specify a workspace ID.
board_id
class-attribute
instance-attribute
Select a board from the drop-down or specify a board ID.
WebhookSubitemColumnChangesResponse
dataclass
CreateItemInput
dataclass
CreateItemInput(workspace_id: Optional[FieldWorkspace] = None, board_id: Optional[FieldBoard] = None, group_id: Optional[str] = None, item_name: Optional[str] = None, column_values: Optional[DynamicResponseGetListSchema] = None)
Create an item
Attributes
group_id
class-attribute
instance-attribute
Select a group from the drop-down or specify a group ID.
CreateItemResponse
dataclass
Response for Create an item
DuplicateBoardInput
dataclass
DuplicateBoardInput(source_workspace_id: Optional[str] = None, source_board_id: Optional[str] = None, duplicated_board_name: Optional[str] = None, duplication_type: Optional[str] = None, destination_workspace_id: Optional[str] = None, destination_folder: Optional[str] = None, keep_board_subscribers: Optional[bool] = None)
Duplicate a board
Attributes
source_workspace_id
class-attribute
instance-attribute
source_workspace_id: Optional[str] = field(default=None, metadata={'wire_name': 'sourceWorkspaceId'})
Select the workspace for the board you want to duplicate.
source_board_id
class-attribute
instance-attribute
Select the board to duplicate.
duplicated_board_name
class-attribute
instance-attribute
duplicated_board_name: Optional[str] = field(default=None, metadata={'wire_name': 'duplicatedBoardName'})
Specify the name of the duplicated board.
duplication_type
class-attribute
instance-attribute
Select the duplication type from the drop-down.
destination_workspace_id
class-attribute
instance-attribute
destination_workspace_id: Optional[str] = field(default=None, metadata={'wire_name': 'destinationWorkspaceId'})
Select the destination workspace for the duplicated board.
DuplicateBoardResponse
dataclass
CreateBoardInput
dataclass
Create a board
Attributes
workspace_id
class-attribute
instance-attribute
Specify the ID of a monday.com workspace.
CreateBoardResponse
dataclass
Response for Create a board
CreateColumnInput
dataclass
CreateColumnInput(workspace_id: Optional[FieldWorkspace] = None, board_id: Optional[FieldBoard] = None, title: Optional[str] = None, description: Optional[str] = None, column_type: Optional[str] = None)
Create a column
Attributes
title
class-attribute
instance-attribute
Specify the title of the column you want to create.
description
class-attribute
instance-attribute
Specify the description of the column you want to create.
CreateColumnResponse
dataclass
Response for Create a column
CreateGroupInput
dataclass
CreateGroupResponse
dataclass
Response for Create a group
UpdateItemColumnInput
dataclass
UpdateItemColumnInput(workspace_id: Optional[str] = None, board_id: Optional[str] = None, column_id: Optional[FieldColumnsToUpdateSingleColumn] = None, item_id: Optional[str] = None, column_values: Optional[DynamicResponseGetSingleColumnSchema] = None)
Update an item's column value
Attributes
workspace_id
class-attribute
instance-attribute
Select the workspace the item belongs to from the drop-down.
board_id
class-attribute
instance-attribute
Select the board the item belongs to from the drop-down.
UpdateItemColumnResponse
dataclass
Response for Update an item's column value
UpdateMultipleItemColumnsInput
dataclass
UpdateMultipleItemColumnsInput(workspace_id: Optional[str] = None, board_id: Optional[str] = None, item_id: Optional[str] = None, item_name: Optional[str] = None, column_values: Optional[DynamicResponseGetListSchema] = None)
Update multiple item column values
Attributes
workspace_id
class-attribute
instance-attribute
Select the workspace the item belongs to from the drop-down.
board_id
class-attribute
instance-attribute
Select the board the item belongs to from the drop-down.
item_id
class-attribute
instance-attribute
Specify the ID of the item to update.
UpdateMultipleItemColumnsResponse
dataclass
Response for Update multiple item column values
MoveItemToGroupInput
dataclass
MoveItemToGroupInput(workspace_id: Optional[FieldWorkspace] = None, board_id: Optional[FieldBoard] = None, group_id: Optional[str] = None, item_id: Optional[str] = None)
Move an item to a group
Attributes
group_id
class-attribute
instance-attribute
Select the group to move the item to from the drop-down.
MoveItemToGroupResponse
dataclass
Response for Move an item to a group
CreateNotificationInput
dataclass
CreateNotificationInput(user_id: Optional[str] = None, target_id: Optional[str] = None, text: Optional[str] = None)
Create a notification
Attributes
user_id
class-attribute
instance-attribute
Select a user from the drop-down or specify a user ID.
target_id
class-attribute
instance-attribute
Specify a board ID or item ID the notification will go to.
CreateNotificationResponse
dataclass
CreateSubitemInput
dataclass
CreateSubitemInput(workspace_id: Optional[FieldWorkspace] = None, board_id: Optional[str] = None, parent_item_id: Optional[str] = None, item_name: Optional[str] = None, column_values: Optional[DynamicResponseGetListSchema] = None)
Create a subitem
Attributes
board_id
class-attribute
instance-attribute
Select a board from the drop-down or specify a board ID.
parent_item_id
class-attribute
instance-attribute
Select a parent item from the drop-down or specify a parent item ID.
CreateSubitemResponse
dataclass
Response for Create a subitem
GetSubitemColumnNamesForGetSubitems
dataclass
CreateUpdateInput
dataclass
CreateUpdateInput(workspace_id: Optional[FieldWorkspace] = None, board_id: Optional[FieldBoard] = None, group_id: Optional[str] = None, item_id: Optional[str] = None, body: Optional[str] = None)
Create an update
Attributes
group_id
class-attribute
instance-attribute
Select a group from the drop-down or specify a group ID.
item_id
class-attribute
instance-attribute
Select an item from the drop-down or specify an item ID.
CreateUpdateResponse
dataclass
Response for Create an update
DynamicResponseGetListSchemaGet
dataclass
CreateWorkspaceInput
dataclass
CreateWorkspaceResponse
dataclass
Response for Create a workspace
DynamicGetGetItemsSchema
dataclass
GetTagsResponse
dataclass
Response for Get tags
GetUsersResponse
dataclass
Response for Get users
GetWorkspacesResponse
dataclass
GetColumnNamesSchemaResponse
dataclass
GetSingleColumnSchemaResponse
dataclass
GetColumnNamesSchemaForWebhookResponse
dataclass
GetSchemaForGetItemsActionResponse
dataclass
GetColumnNamesSchemaForUpdateWebhookResponse
dataclass
GetSubitemColumnNamesResponse
dataclass
GetSubitemSchemaResponse
dataclass
GetColumnNamesSchemaForItemNameChangeWebhookResponse
dataclass
GetColumnNamesSchemaForSubitemNameChangeWebhookResponse
dataclass
GetColumnNamesSchemaForColumnChangesWebhookResponse
dataclass
DynamicResponseGetListSchema
dataclass
DynamicResponseGetSingleColumnSchema
dataclass
DynamicGetColumnNamesForWebhook
dataclass
DynamicGetColumnNamesForUpdateWebhook
dataclass
DynamicGetSubitemColumnNamesForWebhook
dataclass
MondayClient
MondayClient(connection_runtime_url: str, token_provider: Optional[TokenProvider] = None, options: Optional[ConnectorClientOptions] = None)
Bases: ConnectorClientBase
Typed client for monday connector.
Initialize a MondayClient.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
connection_runtime_url
|
str
|
The connection runtime URL from Azure Portal. |
required |
token_provider
|
Optional[TokenProvider]
|
Optional token provider. Defaults to ManagedIdentityTokenProvider. |
None
|
options
|
Optional[ConnectorClientOptions]
|
Optional connector client options. |
None
|
Methods:
create_item_async
async
Create an item
Creates an item in the selected monday.com board and group.
duplicate_board_async
async
Duplicate a board
Duplicates a board in monday.com.
create_board_async
async
Create a board
Creates a board in monday.com.
create_column_async
async
Create a column
Creates a column in monday.com for the specified board.
create_group_async
async
Create a group
Creates a group in monday.com for the specified board.
update_item_column_async
async
Update an item's column value
Updates a single item's column. If the value is blank, the column value will be cleared.
update_multiple_item_columns_async
async
Update multiple item column values
Updates multiple item columns. Leave the column value blank to keep the current value.
move_item_to_group_async
async
Move an item to a group
Moves an item to another group on the same board.
create_notification_async
async
Create a notification
Creates a notification in monday.com for a user for either a specific board or item.
create_subitem_async
async
Create a subitem
Creates a subitem in monday.com for the selected board and parent item.
get_subitems_async
async
Get subitems
Gets subitems in monday.com for a specific item in a board.
create_update_async
async
Create an update
Creates an update in monday.com for a specific item.
get_item_by_id_async
async
Get an item by ID
Gets a monday.com item using the specified item ID and board.
create_workspace_async
async
Create a workspace
Creates a monday.com workspace with a user-specified name and description.
get_items_async
async
get_items_async(workspace_id: str, board_id: str, group_id: str, filter1_column: Optional[str] = None, filter1_operator: Optional[str] = None, filter1_value: Optional[str] = None, filter2_column: Optional[str] = None, filter2_operator: Optional[str] = None, filter2_value: Optional[str] = None, filter3_column: Optional[str] = None, filter3_operator: Optional[str] = None, filter3_value: Optional[str] = None, filter4_column: Optional[str] = None, filter4_operator: Optional[str] = None, filter4_value: Optional[str] = None) -> dict[str, Any] | None
Get items
Gets items in monday.com for a specific board and group. Filter items by column values using the filters found under advanced options. More info on filtering can be found here: https://plugingenie.com/docs/filtering-items.
get_tags_async
async
Get tags
This operation gets monday.com tags.
get_users_async
async
Get users
This operation gets the name, email, and ID of users in your monday.com account.
get_workspaces_async
async
Get workspaces
This operation gets the workspaces from monday.com.
get_boards_async
async
Get boards
This operation gets the boards from monday.com.
get_groups_for_get_items_async
async
Get groups for the Get Items operation
This operation gets the groups from monday.com, which includes the option to select all groups.
get_columns_for_item_filtering_async
async
Get columns for item filtering
This operation gets the columns from monday.com for item filtering.
get_column_filter_operator_async
async
get_column_filter_operator_async(board_id: str, column_id: Optional[str] = None) -> dict[str, Any] | None
Get column filter operator
This operation gets the available item filter operator for the selected monday.com column.
get_column_names_schema_async
async
Get column names for a board ID
This operation gets the column names for a board ID.
get_single_column_schema_async
async
get_single_column_schema_async(board_id: Optional[str] = None, column_id: Optional[str] = None) -> dict[str, Any] | None
Gets single column schema for a board ID
This operation gets the single column schema for a board ID.
get_column_names_schema_for_webhook_async
async
Get column names for a board ID for a webhook
This operation gets the column names for a board ID for a webhook (includes itemId).
get_schema_for_get_items_action_async
async
Get column names for a board ID for a webhook
This operation gets the schema for the GetItems action.
get_column_names_schema_for_update_webhook_async
async
get_column_names_schema_for_update_webhook_async(board_id: Optional[str] = None) -> dict[str, Any] | None
Get column names for a board ID for an update webhook
This operation gets the column names for a board ID for a webhook (includes itemId).
get_subitem_column_names_async
async
Get subitem column names
Gets subitem column names in monday.com given a board ID.
get_subitem_schema_async
async
Get subitem column names
Gets subitem schema in monday.com given a board ID.
get_column_names_schema_for_item_name_change_webhook_async
async
get_column_names_schema_for_item_name_change_webhook_async(board_id: Optional[str] = None) -> dict[str, Any] | None
Get column names schema for column changes
This operation gets the column names for a board ID for a webhook when the item's name changes.
get_column_names_schema_for_subitem_name_change_webhook_async
async
get_column_names_schema_for_subitem_name_change_webhook_async(parent_board_id: str) -> dict[str, Any] | None
Get column names schema for column changes
This operation gets the column names for a board ID for a webhook when the subitem's name changes.
get_column_names_schema_for_column_changes_webhook_async
async
get_column_names_schema_for_column_changes_webhook_async(board_id: Optional[str] = None) -> dict[str, Any] | None
Get column names schema for column changes
This operation gets the column names for a board ID for a webhook (includes itemId).