GraphQL

Node catalog Actions

On this page

Execute GraphQL queries and mutations with variables.

Usage and specifics

Configure a compatible credential and service query or operation. Response shape depends on the service; inspect it before mapping. Account permissions apply to reads and writes.

Technical type : graphql. Runtime : nodulz.

Credentials and prerequisites

GraphQL (integration / graphql). Bearer token for a GraphQL API. Set the URL in the node.

Create credentials in your nodulz instance’s Credentials area, then select them on the node. Availability depends on ownership and sharing. See the credentials guide for access and rotation.

Parameters

Names below are technical keys. Defaults are not a ready-to-run configuration: complete fields required by your operation. Paths containing [] describe list items; some fields depend on the selected mode.

Parameter	Type	Default	Values / limits
`credentialId`	`string`	`""`	-
`endpoint`	`string`	`""`	-
`query`	`string`	`"query { __typename }"`	-
`variables`	`string`	`"{}"`	-
`operationName`	`string`	`""`	-
`failOnErrors`	`boolean`	`true`	-
`timeout`	`number`	`30`	-; ≥ 1, ≤ 600

Configuration help

timeout Timeout (seconds): Between 1 and 600 seconds. Cancellation interrupts the running request.
failOnErrors Fail on GraphQL errors: Also fails on HTTP 200 responses containing errors. Disable to handle partial data and errors in the output.

Initial configuration

Initial catalog configuration example, to adapt before running. Keep secrets in credentials.

json

{
  "credentialId": "",
  "endpoint": "",
  "query": "query { __typename }",
  "variables": "{}",
  "operationName": "",
  "failOnErrors": true,
  "timeout": 30
}

Verification

Test with representative data. Check node output in the inspector and logs, then use editor mapping for downstream fields. A trigger test with a simulated payload does not validate external service delivery.