You can use monday.execute to invoke an action on the parent monday client.

Parameters

Actions

addDocBlock

The addDocBlock method adds a new block to a workdoc. Check out our API documentation to learn more about document blocks.

Parameters

Each block's content is defined by a content JSON object containing multiple attributes, one of which is deltaFormat. Creating new blocks requires familiarity with the Delta format. We recommend using Quill's Delta library to format your content.

Example

const addToDoc = () => {
    const { focusedBlocks } = context;
    const afterBlockId = focusedBlocks[0].id;
    const data = {
      type: "normal text",
      content: {
        deltaFormat: [
          {
            insert: newText
          }
        ]
      },
      afterBlockId
    };


    monday.execute("addDocBlock", data);
    monday.execute("closeDocModal");
  };

addMultiBlocks

The addMultiBlocks method adds multiple blocks to a workdoc. Check out our API documentation to learn more about document blocks.

Parameters

Each block's content is defined by a content JSON object containing multiple attributes, one of which is deltaFormat. Creating updating blocks requires familiarity with the Delta format. We recommend using Quill's Delta library to format your content.

Example

const contentForBlockOne = {
  deltaFormat: [
    {
      "alignment" : center
    	"insert" : "Block one heading"
    	"attributes" : {
    		"bold" : true
    }
  ]
};

const contentForBlockTwo = {
  deltaFormat: [
    {
      "alignment" : left
      "insert" : "Block two heading",
      "attributes" : {
        "underline" : true
      }
    }
  ]
};

monday.execute("addMultiBlocks", {
  afterBlockId: "7f8c145-989f-48bb-b7f8-dc8f91690g42",
  blocks: [
    {
      type: "large title",
      content: contentForBlockOne
    },
    {
      type: "medium title",
      content: contentForBlockTwo
    }
  ]
})

addMultiBlocksFromHtml

The addMultiBlocksFromHtml method adds multiple blocks to the beginning of a workdoc using HTML. It is only available for the doc quickstart AI feature.

Parameters

Example

const html = '<h1>Marketing Brief</h1>\n<h2>Campaign purpose</h2>\n<span>List a purpose</span></html>';

monday.execute("addMultiBlocksFromHtml", {html: html}).then((res) => {});

attachExtensionsToColumn

The attachExtensionsToColumn method attaches the board column extension app feature to a column.

Parameters

This method doesn't have any parameters.

Example

monday.execute("attachExtensionsToColumn");

closeAppFeatureModal

The closeAppFeatureModal method closes the modal window.

Parameters

This method doesn't have any parameters.

Example

monday.execute("closeAppFeatureModal").then((res) => {
  console.log(res.data);
});

closeDialog

The closeDialog method closes the AI assistant's dialog.

Parameters

This method doesn't have any parameters.

Example

monday.execute("closeDialog");

closeDocModal

The closeDocModal method closes the document block modal. The modal will close when the user clicks outside of it if you don't call this method.

Parameters

This method doesn't have any parameters.

Example

monday.execute("closeDocModal");

closeSettings

The closeSettings method closes a view settings window.

Parameters

This method doesn't have any parameters.

Example

monday.execute("closeSettings").then((res) => {
  console.log(res.data);
  // note that method will close view settings, unless settings were already closed
});

confirm

The confirm method opens a confirmation dialog for the user.

Parameters

Example

monday.execute("confirm", {
   message: "Are you sure?", 
   confirmButton: "Let's go!", 
   cancelButton: "No way", 
   excludeCancelButton: false
}).then((res) => {
    console.log(res.data);
    // {"confirm": true}
});

Here's what the confirmation dialog will look like:

detachExtensionsToColumn

The detachExtensionsToColumn method detaches the board column extension app feature from a column.

Parameters

This method doesn't have any parameters.

Example

monday.execute("detachExtensionsToColumn");

moveToNextSelectedTextualBlock

The moveToNextSelectedTextualBlock method opens the app on the next block when multiple are selected. This is only available after calling the openAppOnFirstTextualBlock function and is only used on the doc command AI feature.

Parameters

This method doesn't have any parameters.

Example

monday.execute("moveToNextSelectedTextualBlock").then((res) => {});

moveToPrevSelectedTextualBlock

The moveToPrevSelectedTextualBlock method opens the app on the previous block when multiple are selected. This is only available after calling the openAppOnFirstTextualBlock function and is only used on the doc command AI feature.

Parameters

This method doesn't have any parameters.

Example

monday.execute("moveToPrevSelectedTextualBlock").then((res) => {});

notice

The notice method displays a message at the top of the user's page. It is very useful for success, error, and general messages.

Parameters

Example

monday.execute("notice", { 
   message: "I'm a success message",
   type: "success", // or "error" (red), or "info" (blue)
   timeout: 10000,
});

This is what the success message will look like:

openAppFeatureModal

The openAppFeatureModal method opens a modal window as an iFrame that points to a site of your choice. The modal can render a page in your app by passing a urlPath or urlParams argument. It can also show an external site with the url argument (like a documentation page on your website).

Parameters

Example

monday.execute("openAppFeatureModal", { urlPath, urlParams, height, width }).then((res) => {
   console.log(res.data);
   {"close": true}
   // The above is a callback to see if a user closed the modal from the inside. This is useful should you want to run some logic within the app window. 
});

Opening and closing a modal will look like this:

openAppOnFirstTextualSelectedBlock

The openAppOnFirstTextualSelectedBlock method opens the app modal on the first selected block when multiple are open. It is only available on the doc toolbar AI feature.

Parameters

This method does not have any parameters.

Example

monday.execute("openAppOnFirstTextualSelectedBlock").then((res) => {});

openAppRatingPopup

The openAppRatingPopup method opens a rating dialog that enables users to rate a marketplace app. You can call this once in 24 hours per user and only on iframes of marketplace apps. It can't be called on a user who has already rated the app.

Parameters

This method doesn't have any parameters.

Example

monday.execute('openAppRatingPopup');

openCreateItemDialog

The openCreateItemDialog method opens a modal from which you can create a new item on a specific board. Though this method accepts two parameters, we recommend only using one at a time or none.

Parameters

Example with boardId

monday.execute("openCreateItemDialog", {boardId:1234567890});

Example with boardIds

monday.execute("openCreateItemDialog", {boardIds:[1234567890,0987654321]});

openFilesDialog

The openFilesDialog method opens a modal with the preview of an asset.

Parameters

Example

monday.execute("openFilesDialog", {
  boardId: 12345,
  itemId: 23456,
  columnId: 'files',
  assetId: 34567
})

Opening the file preview dialog will look like this:

openItemCard

The openItemCard method opens a modal with information from the selected item. Users can also create an update or delete the item from the modal.

Parameters

Example

monday.execute("openItemCard", { itemId: item.id });

Here's what the open item card will look like:

openLinkInTab

The openLinkInTab method opens a link in a new tab for views (board views, item views, etc.).

Parameters

Example

monday.execute("openLinkInTab", { url: "https://www.exampleurl.com" });

openPlanSelection

The openPlanSelection method opens the plan selection page or billing tab so users can upgrade or pay for your app. It cannot be tested, and it only works for live marketplace apps.

Users can update their subscriptions when the tab opens by subscribing, upgrading, downgrading, or canceling. For example, users may want to use a feature not available on their plan. You can show them the billing tab so they can upgrade to the next plan tier.

Parameters

Example

monday.execute('openPlanSelection', {isInPlanSelection: true, selectedPlanId: "123456"});

openSettings

The openSettings method opens a view settings window.

Parameters

This method doesn't have any parameters.

Example

monday.execute("openSettings").then((res) => {
  console.log(res.data);
  // note that method will open view settings, unless settings were already opened
});

This is what opening and closing settings looks like:

replaceHighlightText

The replaceHighlightText method replaces the highlighted text with text of your choosing at the beginning of the block. It is only available for the doc command AI feature.

Parameters

Example

monday.execute("replaceHighlightText", { text: "This will replace the highlted text" });

triggerFilesUpload

The triggerFilesUpload method opens a modal to let the current user upload a file to a specific file column. It returns a promise, and the promise is rejected in case of an error.

Required scope: boards:write

After the file is successfully uploaded, the change_column_value event will be triggered. Check out how to subscribe to these events <a href="https://developer.monday.com/apps/docs/mondaylisten#subscribe-to-interaction-based-events-on-the-board" target="_blank>here!

Parameters

Example

monday.execute("triggerFilesUpload", {
  boardId: 12345,
  itemId: 23456,
  columnId: 'files'
})

Triggering the file upload process will look like this:

updateDocBlock

The updateDocBlock method updates a block's content. Check out our API documentation to learn more about document blocks.

Parameters

Each block's content is defined by a content JSON object containing multiple attributes, one of which is deltaFormat. Creating updating blocks requires familiarity with the Delta format. We recommend using Quill's Delta library to format your content.

Example

const updateBlock = async () => {
    const { focusedBlocks, placement } = context;
    const { id } = focusedBlocks[0];
    const content = {
      deltaFormat: [
        {
          insert: "this is a random text"
        }
      ]
  	};

    const res = await monday.execute("updateDocBlock", { id, content });
    await monday.execute("closeDocModal");

  };

updatePostContentAction

The updatePostContentAction method creates or changes the content of an item's update. It is only available for the update AI feature.

Parameters

Example

monday.execute("updatePostContentAction", { suggestedRephrase: "Some text"})

valueCreatedForUser

The valueCreatedForUser method notifies the monday platform that a user gained a first value in an app. You can find more information about this method in our documentation.

Parameters

This method doesn't have any parameters.

Example

monday.execute("valueCreatedForUser");

📘

Join our developer community!

We've created a community specifically for our devs where you can search through previous topics to find solutions, ask new questions, hear about new features and updates, and learn tips and tricks from other devs. Come join in on the fun! 😎