API Reference

SmartChat API Reference

Interact with the SmartChat RAG API via HTTP requests. The API is accessed through a gateway with multiple backend services.

---

Base URL & Routing

Requests follow the format: <base_url>/<service_path>/<route>

Example: https://api-gateway.ai.t-systems.net/config-manager/redoc

Part	Value
Base URL	https://api-gateway.ai.t-systems.net
Service path	config-manager
Route	redoc

---

Registration

Contact the AIFS team via example@t-systems.com for registration.

---

Authentication

Obtain a Bearer Token from the authentication endpoint, then include the access_token in all subsequent requests.

curl

# Authenticate
curl --location '<BASE_URL>/api/v1/auth/user' \
  --header 'Content-Type: application/json' \
  --data '{
    "username": "<USERNAME>",
    "password": "<PASSWORD>"
  }'

# Use the token
curl --location '<BASE_URL>/chat-session-manager/api/v1/sessions/' \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Python

import requests
import json

base_url = "<BASE_URL>"

# Authenticate
payload = json.dumps({"username": "<USERNAME>", "password": "<PASSWORD>"})
headers = {"Content-Type": "application/json"}
response = requests.post(f"{base_url}/api/v1/auth/user", headers=headers, data=payload)

# Add token to headers
headers["Authorization"] = f"Bearer {response.json()['access_token']}"

# Make authenticated requests
response = requests.get(f"{base_url}/chat-session-manager/api/v1/sessions/", headers=headers)
print(response.json())

---

Services

Service	Path	Docs	Description
API Gateway	—	link	Authentication and entrypoint
Config Manager	config-manager	link	Tenant and RAG configurations
User Manager	user-manager	link	Users, roles, and groups
File Manager	file-manager	link	Files, file groups, knowledge bases
Ingest Master	ingest-master	link	File ingestion orchestration
Chat Session Manager	chat-session-manager	link	Sessions, history, feedback
Query Pipeline	query-pipeline	link	Chat response generation