Monday.com icon

Monday.com

Interact with Monday.com API
Join our community

Actions26

Overview

This node integrates with the Monday.com API to manage boards and other resources. Specifically, the Board - Archive operation allows users to archive a specified board on their Monday.com account. Archiving a board is useful for cleaning up your workspace by hiding boards that are no longer active but might be needed later for reference or auditing.

Practical examples:

  • Automatically archive project boards once the project is completed.
  • Archive old marketing campaign boards after their end date to keep the workspace organized.
  • Use in workflows that trigger archiving based on status changes or time-based conditions.

Properties

Name Meaning
Board The board to archive. This property lets you select from available boards in your account.

Output

The output JSON contains an object indicating the success of the archive operation along with the ID of the archived board and some details returned by the API:

{
  "success": true,
  "boardId": "<archived_board_id>",
  "archived": {
    "id": "<archived_board_id>"
  }
}
  • success: Boolean indicating if the archive operation was successful.
  • boardId: The ID of the board that was archived.
  • archived: Contains the archived board's ID as confirmation from the API.

No binary data output is produced by this operation.

Dependencies

  • Requires an API authentication token credential for Monday.com.
  • Uses Monday.com GraphQL API (version defaulting to "2023-10" unless overridden).
  • The node depends on the Monday.com API client bundled within the node code.

Troubleshooting

  • Common issues:

    • Invalid or expired API token: The node will fail to authenticate with Monday.com.
    • Specifying a non-existent or already archived board ID may cause errors or unexpected results.
    • Network connectivity issues can prevent the node from reaching the Monday.com API.

  • Error messages:

    • Authentication errors typically indicate invalid credentials; verify and update the API token.
    • Errors about missing or invalid board IDs suggest checking the input board selection.
    • If the node throws an error related to GraphQL mutation execution, ensure the board ID is correct and the user has permissions to archive it.

  • Resolution tips:

    • Confirm the API token is valid and has sufficient permissions.
    • Use the board selection dropdown to avoid manual ID entry errors.
    • Check Monday.com user permissions for archiving boards.
    • Enable "Continue On Fail" in the node settings to handle errors gracefully in workflows.

Links and References

Discussion