Create seamless integrations with Wisdom AI 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 Wisdom AI 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 support@askwisdom.ai 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 CodeMessageCause
401UnauthorizedInvalid or missing authentication token
400Bad RequestMalformed request payload
500Internal Server ErrorUnexpected API failure
For any queries or support, contact our API team at support@askwisdom.ai.

​
Next Steps

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