Worktables

Overview

This node enables interaction with Monday.com (referred to as "Worktables" in the code) via its GraphQL API. It supports multiple resources such as boards, items, updates, teams, users, and custom queries. Specifically for the Query resource with the Run API operation, it allows users to run arbitrary GraphQL queries against the Monday.com API.

Common scenarios where this node is beneficial include:

• Executing custom or complex GraphQL queries that are not covered by predefined operations.
• Fetching specific data from Monday.com that requires tailored queries.
• Integrating Monday.com data retrieval or mutation into automated workflows with full flexibility.

Practical example:

• A user wants to retrieve detailed information about a board including nested fields not exposed by other operations. They can write a custom GraphQL query and run it directly using this node.

Properties

Output

The output of the node is a JSON object representing the parsed response from the Monday.com GraphQL API corresponding to the executed query. The structure depends entirely on the query provided by the user.

• The json field contains the full JSON response from the API.
• No binary data output is produced by this operation.

Example output snippet (generic):

{
  "data": {
    // Data fields returned by the custom query
  }
}

Dependencies

• Requires an API key credential for Monday.com (referred to generically as "an API key credential").
• The node makes HTTP POST requests to the Monday.com GraphQL endpoint: https://api.monday.com/v2.
• The API key must be configured in n8n credentials for authentication.

Troubleshooting

• API Key Not Found: If the API key credential is missing or invalid, the node will throw an error indicating the API key was not found. Ensure the credential is properly set up in n8n.
• Invalid Query: If the GraphQL query syntax is incorrect or references invalid fields, the API will return errors. Verify the query syntax and field names according to Monday.com's GraphQL API documentation.
• Empty Query: If no query is provided, the node throws an error "Invalid item data." Always provide a valid GraphQL query string.
• Unsupported Operation: If an unsupported operation is selected, the node throws an error specifying the unsupported operation. For the Query resource, only the "Run API" operation is supported.

Links and References

• Monday.com GraphQL API Documentation: https://api.developer.monday.com/docs/apis-overview-introduction
• n8n Expressions and Credentials Documentation: https://docs.n8n.io/code-examples/expressions/
• Monday.com API Authentication Guide: https://api.developer.monday.com/docs/authentication

This summary focuses exclusively on the Query resource and Run API operation as requested, based on static analysis of the provided source code.