Exchange an access key for a JWT token that impersonates a specific user for authentication with the GraphQL API.

​
impersonateUser

This query exchanges a dedicated access key for a JWT token that can be used to authenticate subsequent GraphQL API requests while impersonating a specific user. This is useful for embedding scenarios where you need to authenticate as a particular user.

​
Signature

impersonateUser(accessToken: String!, userEmail: String!): String!

​
Parameters

​
accessToken
String!
required
The dedicated access key provided by WisdomAI for your organization. Contact support@askwisdom.ai to obtain your access key. The access key will have impersonation permissions.
​
userEmail
String!
required
The email address of the user to impersonate. This user must exist in the WisdomAI system and the access token must have impersonation permissions.

​
Response

Returns a JWT token as a string that should be used in the Authorization header for subsequent API requests. This JWT will authenticate as the impersonated user.

​
Usage Example

query ImpersonateUser($accessToken: String!, $userEmail: String!) {
  impersonateUser(accessToken: $accessToken, userEmail: $userEmail)
}

curl -X POST https://{ACCOUNT}.askwisdom.ai/graphql \
  -H "Content-Type: application/json" \
  -d '{
    "query": "query ImpersonateUser($accessToken: String!, $userEmail: String!) { impersonateUser(accessToken: $accessToken, userEmail: $userEmail) }",
    "variables": {
      "accessToken": "your-access-key-here",
      "userEmail": "user-email@yourcompany.com"
    }
  }'
JWT tokens have a limited lifetime. You will need to exchange your access key for a new JWT token periodically.

GraphQL API Overview

Complete GraphQL API authentication guide

Embed Story

Authentication for embedded story integrations