WorktablesInstall

Overview

This node enables interaction with Monday.com via its GraphQL API, allowing users to perform various operations on different resources such as boards, items, updates, teams, users, and custom queries. Specifically, the Query - Run API operation lets users run arbitrary GraphQL queries against the Monday.com API.

Common scenarios include:

• Running custom or complex queries that are not covered by predefined operations.
• Fetching specific data from Monday.com by writing tailored GraphQL queries.
• Integrating Monday.com data retrieval or mutation into automated workflows where flexibility is required.

Practical example:

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

Properties

Output

The output of the node is a JSON object representing the parsed response from the Monday.com GraphQL API for the executed query. It contains the data returned by the query, which can vary widely depending on the query content.

• The output is always JSON.
• No binary data output is produced by this operation.
• The structure of the JSON matches the shape of the GraphQL response, typically containing a data field with requested entities or mutations results.

Example output (simplified):

{
  "data": {
    "boards": [
      {
        "id": "12345",
        "name": "Project Board",
        "items": [...]
      }
    ]
  }
}

Dependencies

• Requires an API key credential for Monday.com with appropriate permissions.
• 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 and linked to this node.
• No additional external dependencies beyond the Monday.com API and n8n's HTTP request helper.

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 and linked.
• Invalid Query: If the provided GraphQL query is malformed or invalid according to Monday.com's schema, the API will return an error. Verify the query syntax and validity using Monday.com's API documentation or GraphQL playground.
• Unsupported Operation: If an unsupported operation is specified (not applicable here since only "Run API" is supported under "query" resource), the node throws an error.
• Empty Query: Providing an empty query string will cause an error "Invalid item data." Always provide a valid GraphQL query string.
• Network Issues: Connectivity problems to the Monday.com API endpoint will result in request failures. Check network access and proxy settings if applicable.

Links and References

• Monday.com GraphQL API Documentation: https://api.developer.monday.com/docs/apis-overview-introduction
• Monday.com GraphQL Explorer: https://monday.com/developers/v2/try-it-yourself/
• n8n HTTP Request Node Documentation: https://docs.n8n.io/nodes/n8n-nodes-base.httpRequest/

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