Skip to main content
While each Modus SDK offers similar capabilities, the APIs and usage may vary between languages.Modus GraphQL APIs documentation is available on the following pages:
The Modus GraphQL APIs allow you to securely call and fetch data from any GraphQL endpoint.

​
Import

To begin, import the graphql namespace from the SDK: 
import { graphql } from "@hypermode/modus-sdk-as"

​
GraphQL APIs

The APIs in the graphql namespace are below, organized by category.
We’re constantly introducing new APIs through ongoing development with early users. Please open an issue if you have ideas on what would make Modus even more powerful for your next app!

​
Functions

​
execute

Execute a GraphQL statement to call a query or apply mutation against a GraphQL endpoint. 
function execute<T>(
  connection: string,
  statement: string,
  variables?: Variables,
): Response<T>
​
T
required
Type of object to use for the data returned from the query. This can be any type, including a custom type defined in your project. It should match the shape of the data returned from the GraphQL query.
Define custom types in the project’s source code. In AssemblyScript, create classes decorated with @json.All types, including classes, base classes, and field types must be JSON serializable. You can also use built-in types such as strings, numbers, arrays, and maps.
​
connection
string
required
Name of the connection, as defined in the manifest.
​
statement
string
required
GraphQL statement containing the query or mutation operation to execute.
While it’s possible to directly include parameter values into your GraphQL statement, it’s highly recommended to pass a Variables object instead. This can help to prevent against injection attacks and other security vulnerabilities.
​
variables
Variables
Optional variables to include with the query.See the details of the Variables object for more information.

​
Types

​
Variables

A container for variables to include with a GraphQL operation. To use this feature, create a new Variables object and call the set method for each variable you want to include. Then pass the object to the execute function. 
class Variables {
  set<T>(name: string, value: T): void
  toJSON(): string
}
​
set(name, value)
Set a variable with a name and value to include with the GraphQL operation.
​
toJSON()
string
Serializes the variables to a JSON string for inclusion in the GraphQL operation. The execute function calls this automatically when you pass a Variables object. You typically don’t need to call it directly.

​
Response

A response object from the GraphQL query. Either errors or data is present, depending on the result of the query. 
class Response<T> {
  errors: ErrorResult[] | null
  data: T | null
}
​
errors
ErrorResult[]
An array of errors incurred as part of your GraphQL request, if any.Each error in the array is an ErrorResult object. If there are no errors, this field is null.
​
data
T
The resulting data selected by the GraphQL operation.The data has the type specified in the call to the execute function. If data is absent due to errors, this field is null.

​
ErrorResult

The details of an error incurred as part of a GraphQL operation. 
class ErrorResult {
  message: string
  locations: CodeLocation[] | null
  path: string[] | null
}
​
message
string
Description of the error incurred.
​
locations
CodeLocation[]
An array of CodeLocation objects that point to the specific location of the error in the GraphQL statement.
​
path
string[]
Path to the area of the GraphQL statement related to the error.Each item in the array represents a segment of the path.

​
CodeLocation

The location of specific code within a GraphQL statement. 
class CodeLocation {
  line: u32
  column: u32
}
​
line
u32
Line number within the GraphQL statement for the code.
​
column
u32
Column number within the GraphQL statement for the code.