CHANGELOG

• July 8, 2025 [Release:2507]: Change in document-related routes

  Impact on routes:

  • Document list
  • Adding document(s)
  • Viewing document metadata
  • Deleting a document

• October 24, 2025: Addition of data source-related routes

• February 5, 2026: New source citation route

Introduction

The purpose of this page is to explain the main integration principles of the Wikit Semantics solution along two axes:

• Executing queries on "Question-Answering" LLM Apps
• Administering data sources for "Question-Answering" LLM Apps

It covers only the Wikit Semantics REST API associated with these two points.

This documentation is intended for any software integrator wishing to benefit from Generative AI in a third-party solution or an external information system.

Authentication and authorization

Two authentication & authorization mechanisms are implemented:

• API Key for the query execution API, available on request
• OAuth2 for the administration API

Authentication for the administration API

Authentication for the Wikit Semantics administration API is based on Wikit's cross-functional IAM service.

The authentication and authorization service implements OpenID Connect, which uses OAuth2 mechanisms.

OAuth2 token generation is performed using the following information:

• Realm: wikit-prod
• Client ID: semantics-console
• Connection information: username / password of the user account with API access.

curl -L -X POST 'https://auth.wikit.ai/realms/wikit-prod/protocol/openid-connect/token' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode "client_id=semantics-console" \
  --data-urlencode "grant_type=password" \
  --data-urlencode "username=$SEMANTICS_USERNAME" \
  --data-urlencode "password=$SEMANTICS_PASSWORD"

Contact

For any questions, contact the support team (support@wikit.ai) or your usual Wikit contact.