​
GraphQL API

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.

​
Getting 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

​
Connection URL

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

​
Connection Parameters

ParameterTypeDescription
auth.tokenStringJWT session token for authentication
Example: 
{
  "auth": {
    "token": "<SESSION_TOKEN>"
  }
}

​
Authentication

The GraphQL API uses API key authentication. Include your API key in the Authorization header: 
Authorization: Bearer YOUR_API_KEY

​
Error Handling

Error CodeMessageCause
401UnauthorizedInvalid or missing authentication token
400Bad RequestMalformed request payload
500Internal Server ErrorUnexpected API failure

​
Contact & Support

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