About GraphQL

The Tenable One Cloud Exposure GraphQL API offers flexibility and the ability to precisely define the data you want to fetch.

The GraphQL data query language is:

• A specification — The spec determines the validity of the schema on the API server. The schema determines the validity of client calls.
• Strongly typed — The schema defines an API's type system and all object relationships.
• Introspective — A client can query the schema for details about the schema.
• Hierarchical — The shape of a GraphQL call mirrors the shape of the JSON data it returns. Nested fields let you query for and receive only the data you specify in a single round trip.
• An application layer — GraphQL is not a storage model or a database query language. The graph refers to graph structures defined in the schema, where nodes define objects and edges define relationships between objects. The API traverses and returns application data based on the schema definitions, independent of how the data is stored.

Why Use GraphQL

Tenable chose GraphQL for its API because it offers significantly more flexibility. The ability to precisely define the data you want is a powerful advantage. GraphQL lets you replace multiple REST requests with a single call to fetch the data you specify.

About the Tenable GraphQL Schema

You can find the full Cloud Exposure GraphQL API schema in the GraphiQL explorer. All calls are validated and executed against the schema. Use the explorer to find out what data you can call:

• Allowed operations: Queries and Mutations.
• Schema-defined types: Objects, Interfaces, Enums, and Input Objects.

To learn more about how to begin working with GraphQL, see Get Started.