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 Session Token

  • Use the exchange_access_key method from Descope to exchange an access key for a session token.
  • Python Example: 
    from descope import DescopeClient
descope_client = DescopeClient(project_id=WISDOM_PROJECT_ID)
auth_info = descope_client.exchange_access_key(WISDOM_AUTH_KEY)
auth_token = auth_info["sessionToken"]["jwt"]
2

Pass Token in Requests

The session token is required in the WebSocket connection payload and query parameters.
Authorization: Bearer YOUR_SESSION_TOKEN
Contact our API team at support@askwisdom.ai to obtain your dedicated access 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

Objects

Explore the complete type system and object definitions

Queries

Learn about available queries for fetching data

Mutations

Discover mutations for creating and updating resources

Subscriptions

Real-time data subscriptions and live updates