Actions10
Execute Custom GraphQL
AI-generatedOverview
This node allows users to execute custom GraphQL queries against the Blue Project Management API. It is useful for retrieving or manipulating project management data such as projects, companies, users, tags, and custom fields by writing specific GraphQL queries tailored to the user's needs. For example, a user can query project details, fetch lists of companies, or update project information using custom GraphQL queries.
Use Case Examples
- Retrieve a list of projects with their IDs, names, and statuses.
- Fetch detailed information about a specific company or project user.
- Execute complex queries involving multiple related entities in the Blue Project Management system.
Properties
| Name | Meaning |
|---|---|
| GraphQL Query | The GraphQL query string to be executed against the Blue API. |
| Variables (JSON) | JSON object containing variables to pass to the GraphQL query. |
| Timeout (Ms) | Request timeout in milliseconds for the GraphQL query execution. |
| Return Full Response | Boolean flag indicating whether to return the full GraphQL response including errors and extensions. |
Output
JSON
json- The JSON data returned from the GraphQL query execution, or error information if the query failed.
Dependencies
- Requires an API key credential for Blue API authentication.
Troubleshooting
- Common issues include malformed GraphQL queries causing errors from the API.
- Timeouts if the query takes too long to execute; adjust the timeout option accordingly.
- Errors returned from the API are included in the response if 'Return Full Response' is enabled, otherwise they cause node failure unless 'Continue On Fail' is enabled.
Links
- Blue Project Management GraphQL API Documentation - Official documentation for the Blue API GraphQL endpoints and query structure.