# ExecuteQuery Required Frends version: 5.7+ Required .NET version: 8.0 Compatible Agents: Unknown Source code: {% tabs %} {% tab title="Parameter: Input" %} | Name | Description | | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Query : `String` |

GraphQl Query

Default: -
Example: query ($surname: String!) { users(surname: $surname) { id name } }

| | Variables : `Variable[]` |

GraphQl variables for query

Default: -
Example: \[{"key" : "surname", "value" : "Doe"}]

| | OperationName : `String` |

The name of the operation to execute. Required if the query contains multiple operations.

Default: -
Example: GetUser

| | Extensions : `Variable[]` |

Additional entries for protocol extensions. This is a map of additional metadata.

Default: -
Example: \[{"key" : "persistedQuery", "value" : {"version": 1, "sha256Hash": "abc123"}}]

| | {% endtab %} | | {% tab title="Parameter: Connection" %} | Name | Description | | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | EndpointUrl : `String` |

Url to GraphQl server.

Default: -
Example:

| | Authentication : `Authentication` |

Method of authenticating a request

Possible values:

None:

Method of authenticating a request

Basic:

Method of authenticating a request

OAuth:

Method of authenticating a request

Default: -
Example: OAuth

| | Username : `String` |

If Basic Authentication is selected, you should use a username

Default: -
Example: Username

| | 🗝Password : `String` |

Password for the username

Default: -
Example: Password123

| | 🗝BearerToken : `String` |

Bearer token to be used for request. Token will be added as an Authorization header.

Default: -
Example: Token123

| | Method : `Method` |

The HTTP Method to be used with the request.

Possible values:

Get:

The HTTP Method to be used with the request.

Post:

The HTTP Method to be used with the request.

Default: 1
Example: GET

| | Headers : `Header[]` |

List of HTTP headers to be added to the request.

Default: -
Example: Name: Header, Value: HeaderValue

| | {% endtab %} | | {% tab title="Parameter: Options" %} | Name | Description | | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | ThrowErrorOnFailure : `Boolean` |

Whether to throw an error on failure.

Default: True
Example: false

| | ErrorMessageOnFailure : `String` |

Overrides the error message on failure.

Default: -
Example: Custom error message

| | ConnectionTimeoutSeconds : `Int32` |

Timeout in seconds to be used for the connection and operation.

Default: 30
Example: 30

| | AllowInvalidCertificate : `Boolean` |

Do not throw an exception on a certificate error.

Default: False
Example: true

| | {% endtab %} | | {% tab title="Result: Result" %} | Name | Description | | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | Success : `Boolean` |

Indicates if the task completed successfully.
Example: true

| | Data : `JObject` |

Content of the returned response
Example: foobar,foobar

| | Headers : `Header[]` |

Array of response headers
Example: Name: Header, Value: HeaderValue

| | Error : `Error` |

Error that occurred during task execution.
Example: object { string Message, object { Exception exception } AdditionalInfo }

| | {% endtab %} | | {% tab title="Changelog" %} ## Changelog ### \[2.0.0] - 2025-11-14 #### Changed * **BREAKING**: Variable values now support complex types (objects, arrays) instead of only strings. Variables are properly serialized without double-serialization. * GET method now uses JSON serialization for variables instead of manual string construction. * GraphQL response errors are now properly detected. Result.Success is set to false when the response contains errors, and an exception is thrown when ThrowErrorOnFailure is enabled. #### Added * Support for operationName field to specify which operation to execute when a query contains multiple operations. * Support for extensions field for protocol extensions and additional metadata. ### \[1.1.0] - 2025-07-31 #### Changed * Make default error message empty by default ### \[1.0.0] - 2025-06-03 #### Added * Initial implementation {% endtab %} {% endtabs %}