GraphQL API

Create seamless integrations with WisdomAI using our comprehensive GraphQL API. Access domains, tables, and analytics data programmatically to build custom applications and workflows.

The GraphQL API is designed for external integrations. All operations require proper authentication and respect your organization’s access controls.

Get Started

The Wisdom API provides real-time access to structured data insights via a WebSocket-based subscription model. Users can ask questions related to business intelligence and receive structured responses, including tabular data and SQL queries.

The WisdomAI GraphQL API provides a single endpoint for all operations:

https://{ACCOUNT}.askwisdom.ai/graphql

WebSocket Connection

Use the following URL to establish the WebSocket connection:

wss://{ACCOUNT}.askwisdom.ai/graphql

Authentication

The APIs require authentication using a JWT session token obtained via the Descope authentication system.

The authentication flow consists of the following steps:

1. Obtain Access Key

   Contact WisdomAI support at [e-mail] to obtain your dedicated access key.

2. Exchange Access Key for JWT Token

   Use WisdomAI’s GraphQL API exchangeAccessToken query to exchange your access key for a JWT token.

   • GraphQL Query:

     query ExchangeAccessToken($accessToken: String!) {
       exchangeAccessToken(accessToken: $accessToken)
     }
     
3. Pass Token in Requests

   The session token is required in all API requests and WebSocket connection payload.

   Authorization: Bearer YOUR_SESSION_TOKEN
   

Error Handling

Error Code	Message	Cause
401	Unauthorized	Invalid or missing authentication token
400	Bad Request	Malformed request payload
500	Internal Server Error	Unexpected API failure

For any queries or support, contact our API team at [e-mail].

Related Operations

Exchange Access Token

Authenticate with the GraphQL API using access keys

Queries

Learn about available queries for fetching data

Mutations

Discover mutations for creating and updating resources

Subscriptions

Real-time data subscriptions and live updates