Ur repot
API-ytan — varje endpoint, per tjänst
Genererad ur tjänsternas incheckade openapi.json av
tools/checks/check_api_surface.py. Redigera inte för hand — regenerera med
python3 tools/checks/check_api_surface.py --write. Vakten fäller pre-commit om
filen och kontrakten glider isär.
Kedjan är kod → openapi.json → den här filen: check_openapi_drift.py håller
kontraktet identiskt med det appen exponerar, den här vakten håller tabellen
identisk med kontraktet. En endpoint som står här finns alltså i koden.
Vad som INTE står här: MCP-verktygsytan (bor i mcp-gatewayens registry),
frontend-rutter, och break-glass-CLI:t (se control-surfaces.md).
Auth-modell, tabeller och anropare per tjänst: atlas.md.
Varför ytorna ligger som de gör: arkitektur.md.
200 operationer i 13 tjänster.
| Tjänst | Operationer |
|---|---|
agent-runtime |
6 |
auth-api |
31 |
bff |
48 |
eval-api |
6 |
extract-api |
2 |
feedback-api |
10 |
lifecycle-api |
14 |
llm-gateway |
20 |
mcp-gateway |
17 |
pii-api |
2 |
policy-engine |
17 |
provisioning-api |
11 |
rag-api |
16 |
agent-runtime — 6 operationer
| Metod | Sökväg | Beskrivning |
|---|---|---|
GET |
/healthz |
Healthz |
GET |
/readyz |
Readyz |
POST |
/v1/sessions |
Create Session |
DELETE |
/v1/sessions/{session_id} |
Delete Session |
GET |
/v1/sessions/{session_id} |
Get Session |
POST |
/v1/sessions/{session_id}/turns |
Run Turn |
auth-api — 31 operationer
| Metod | Sökväg | Beskrivning |
|---|---|---|
GET |
/.well-known/jwks.json |
Jwks |
GET |
/.well-known/openid-configuration |
Openid Config |
GET |
/healthz |
Healthz |
GET |
/readyz |
Readyz |
GET |
/v1/admin/tenants/{tenant_id}/channel-identities |
List Channel Identities |
DELETE |
/v1/admin/tenants/{tenant_id}/channel-identities/{channel}/{team_id}/{external_user_id} |
Unmap Channel Identity |
PUT |
/v1/admin/tenants/{tenant_id}/channel-identities/{channel}/{team_id}/{external_user_id} |
Map Channel Identity |
GET |
/v1/admin/tenants/{tenant_id}/export |
Export Tenant |
DELETE |
/v1/admin/tenants/{tenant_id}/group-mappings |
Delete Mapping |
GET |
/v1/admin/tenants/{tenant_id}/group-mappings |
List Mappings |
POST |
/v1/admin/tenants/{tenant_id}/group-mappings |
Create Mapping |
GET |
/v1/admin/tenants/{tenant_id}/role-bindings |
List Bindings |
POST |
/v1/admin/tenants/{tenant_id}/role-bindings |
Create Binding |
DELETE |
/v1/admin/tenants/{tenant_id}/role-bindings/{user_id} |
Delete Bindings For User |
GET |
/v1/admin/tenants/{tenant_id}/service-clients |
List Service Clients |
DELETE |
/v1/admin/tenants/{tenant_id}/service-clients/{client_id}/channel |
Revoke Channel |
PUT |
/v1/admin/tenants/{tenant_id}/service-clients/{client_id}/channel |
Grant Channel |
DELETE |
/v1/admin/tenants/{tenant_id}/service-clients/{client_id}/delegation |
Revoke Delegation |
PUT |
/v1/admin/tenants/{tenant_id}/service-clients/{client_id}/delegation |
Grant Delegation |
GET |
/v1/admin/tenants/{tenant_id}/users |
List Users |
POST |
/v1/admin/tenants/{tenant_id}/users |
Invite User |
POST |
/v1/admin/tenants/{tenant_id}/users/{user_id}/enable |
Enable User |
POST |
/v1/admin/tenants/{tenant_id}/users/{user_id}/erase |
Erase User |
POST |
/v1/admin/tenants/{tenant_id}/users/{user_id}/export |
Export User |
POST |
/v1/admin/tenants/{tenant_id}/users/{user_id}/revoke |
Revoke User |
GET |
/v1/me |
Me |
GET |
/v1/oauth/callback |
Oauth Callback |
POST |
/v1/token/channel |
Token Channel |
POST |
/v1/token/client |
Token Client |
POST |
/v1/token/delegate |
Token Delegate |
POST |
/v1/token/exchange |
Token Exchange |
bff — 48 operationer
| Metod | Sökväg | Beskrivning |
|---|---|---|
GET |
/.well-known/security.txt |
Security Txt |
GET |
/api/chat/v1/conversations |
List Conversations |
POST |
/api/chat/v1/conversations |
Create Conversation |
DELETE |
/api/chat/v1/conversations/{conversation_id} |
Delete Conversation |
GET |
/api/chat/v1/conversations/{conversation_id} |
Get Conversation |
GET |
/api/chat/v1/conversations/{conversation_id}/export |
Export Conversation |
POST |
/api/chat/v1/conversations/{conversation_id}/messages |
Post Message |
GET |
/api/chat/v1/models |
List Chat Models |
GET |
/api/chat/v1/records |
List Records |
POST |
/api/chat/v1/records |
Register Record |
PATCH |
/api/chat/v1/records/{record_id} |
Patch Record |
GET |
/api/chat/v1/records/{record_id}/disclose |
Disclose Record |
POST |
/api/chat/v1/uploads/file |
File Upload |
POST |
/api/chat/v1/uploads/scan |
Scan Upload |
GET |
/api/models |
List Models |
POST |
/api/policy/v1/assistants |
Create Assistant |
PATCH |
/api/policy/v1/assistants/{assistant_id} |
Patch Assistant |
POST |
/api/policy/v1/decide |
Decide Probe |
GET |
/api/public-sites |
List Sites |
POST |
/api/public-sites |
Create Site |
POST |
/api/public-sites/maintenance/sweep |
Sweep |
POST |
/api/public-sites/{site_id}/forensics/{session_id}/unlock |
Unlock Forensics |
POST |
/api/public-sites/{site_id}/revoke |
Revoke Site |
POST |
/api/rag/v1/documents/file |
Knowledge File |
DELETE |
/api/{service}/{path} |
Passthrough Delete |
GET |
/api/{service}/{path} |
Passthrough Get |
PATCH |
/api/{service}/{path} |
Passthrough Patch |
POST |
/api/{service}/{path} |
Passthrough Post |
PUT |
/api/{service}/{path} |
Passthrough Put |
GET |
/auth/callback |
Callback |
GET |
/auth/logged-out |
Logged Out |
GET |
/auth/login |
Login |
POST |
/auth/logout |
Logout |
POST |
/chat |
Chat |
GET |
/gdpr/tenants/{tenant_id}/export |
Export Tenant |
POST |
/gdpr/users/{user_id_hash}/conversations/erase |
Erase Subject Conversations |
GET |
/gdpr/users/{user_id_hash}/conversations/export |
Export Subject Conversations |
GET |
/healthz |
Healthz |
GET |
/internal/k21/avslag |
Geo Denied |
POST |
/internal/k21/avslag |
Geo Denied |
GET |
/internal/k21/regel |
Rule State |
POST |
/internal/k21/regel |
Rule Notice |
GET |
/me |
Me |
POST |
/public/chat |
Public Chat |
POST |
/public/feedback |
Feedback |
GET |
/public/service-info |
Service Info |
POST |
/public/session |
Create Session |
GET |
/readyz |
Readyz |
eval-api — 6 operationer
| Metod | Sökväg | Beskrivning |
|---|---|---|
GET |
/health |
Health |
GET |
/v1/assistants/{assistant_id}/eval-set |
Get Eval Set |
PUT |
/v1/assistants/{assistant_id}/eval-set |
Put Eval Set |
GET |
/v1/assistants/{assistant_id}/runs |
List Runs |
POST |
/v1/assistants/{assistant_id}/runs |
Post Run |
GET |
/v1/eval-status |
Get Eval Status |
extract-api — 2 operationer
| Metod | Sökväg | Beskrivning |
|---|---|---|
GET |
/healthz |
Healthz |
POST |
/v1/extract |
Extract |
feedback-api — 10 operationer
| Metod | Sökväg | Beskrivning |
|---|---|---|
GET |
/healthz |
Healthz |
GET |
/readyz |
Readyz |
GET |
/v1/assistants/{assistant_id}/quality-signals |
Get Quality Signals |
GET |
/v1/feedback |
List Admin |
POST |
/v1/feedback |
Post Feedback |
POST |
/v1/feedback/erase |
Erase Feedback By Traces |
POST |
/v1/feedback/query |
Query Feedback By Traces |
GET |
/v1/feedback/tenants/{tenant_id}/export |
Export Tenant |
DELETE |
/v1/feedback/{score_id} |
Delete Feedback |
GET |
/v1/feedback/{trace_id} |
Get By Trace |
lifecycle-api — 14 operationer
| Metod | Sökväg | Beskrivning |
|---|---|---|
GET |
/healthz |
Healthz |
GET |
/readyz |
Readyz |
GET |
/v1/assistants/{assistant_id}/activation-check |
Activation Check |
GET |
/v1/change-events |
List Change Events |
GET |
/v1/obligations-dossier |
List Dossiers |
POST |
/v1/obligations-dossier |
Create Dossier |
GET |
/v1/obligations-dossier/{dossier_id} |
Get Dossier |
PATCH |
/v1/obligations-dossier/{dossier_id} |
Patch Dossier |
POST |
/v1/obligations-dossier/{dossier_id}/activate |
Activate Dossier |
POST |
/v1/obligations-dossier/{dossier_id}/archive |
Archive Dossier |
GET |
/v1/reassessment-tasks |
List Tasks |
POST |
/v1/reassessment-tasks |
Create Task |
GET |
/v1/reassessment-tasks/{task_id} |
Get Task |
PATCH |
/v1/reassessment-tasks/{task_id} |
Patch Task |
llm-gateway — 20 operationer
| Metod | Sökväg | Beskrivning |
|---|---|---|
GET |
/admin/audit |
Audit |
DELETE |
/admin/keys/{key_id} |
Revoke Key |
PATCH |
/admin/keys/{key_id} |
Patch Key |
GET |
/admin/tenants/{tenant_id}/budget |
Get Budget |
PUT |
/admin/tenants/{tenant_id}/budget |
Set Budget |
GET |
/admin/tenants/{tenant_id}/export |
Tenant Export |
GET |
/admin/tenants/{tenant_id}/keys |
List Keys |
POST |
/admin/tenants/{tenant_id}/keys |
Create Key |
GET |
/admin/tenants/{tenant_id}/usage |
Tenant Usage |
GET |
/admin/tenants/{tenant_id}/usage/by-group |
Tenant Usage By Group |
GET |
/admin/tenants/{tenant_id}/usage/by-user |
Tenant Usage By User |
PUT |
/admin/tenants/{tenant_id}/webhook |
Set Webhook |
GET |
/admin/usage/summary |
Summary |
GET |
/health |
Health |
GET |
/health/watchdog |
Health Watchdog |
POST |
/v1/audio/transcriptions |
Transcriptions |
POST |
/v1/chat/completions |
Chat Completions |
POST |
/v1/embeddings |
Embeddings |
GET |
/v1/models |
List Models |
POST |
/v1/rerank |
Rerank |
mcp-gateway — 17 operationer
| Metod | Sökväg | Beskrivning |
|---|---|---|
GET |
/healthz |
Healthz |
GET |
/readyz |
Readyz |
POST |
/v1/admin/knowledge/preview |
Knowledge Preview Endpoint |
GET |
/v1/admin/mcp-servers |
List Servers |
POST |
/v1/admin/mcp-servers |
Register |
DELETE |
/v1/admin/mcp-servers/{server_id} |
Delete Server |
GET |
/v1/admin/mcp-servers/{server_id} |
Get Server |
PATCH |
/v1/admin/mcp-servers/{server_id} |
Patch Server |
GET |
/v1/admin/mcp-servers/{server_id}/grants |
List Grants |
POST |
/v1/admin/mcp-servers/{server_id}/grants |
Create Grant |
DELETE |
/v1/admin/mcp-servers/{server_id}/grants/{grant_id} |
Delete Grant |
POST |
/v1/admin/mcp-servers/{server_id}/rediscover |
Rediscover |
PATCH |
/v1/admin/mcp-servers/{server_id}/tools/{tool_name}/scope |
Update Tool Scope |
GET |
/v1/admin/tool-usage |
Get Tool Usage |
GET |
/v1/operator/tenants/{tenant_id}/tool-usage |
Get Tool Usage For Operator |
GET |
/v1/tools |
List Tools |
POST |
/v1/tools/call |
Call Tool |
pii-api — 2 operationer
| Metod | Sökväg | Beskrivning |
|---|---|---|
GET |
/healthz |
Healthz |
POST |
/v1/analyze |
Analyze |
policy-engine — 17 operationer
| Metod | Sökväg | Beskrivning |
|---|---|---|
GET |
/healthz |
Healthz |
GET |
/readyz |
Readyz |
GET |
/v1/admin/decisions |
List Decisions |
GET |
/v1/admin/decisions/traces |
Decision Traces |
GET |
/v1/admin/decisions/verify |
Verify Decisions |
GET |
/v1/admin/protection-defaults |
Get Protection Defaults |
PUT |
/v1/admin/protection-defaults |
Put Protection Defaults |
GET |
/v1/admin/retention |
Get Retention |
PUT |
/v1/admin/retention/{data_category} |
Put Retention |
GET |
/v1/admin/tenants/{tenant_id}/export |
Export Tenant |
GET |
/v1/assistants |
List Assistants |
POST |
/v1/assistants |
Create Assistant |
GET |
/v1/assistants/{assistant_id} |
Get Assistant |
PATCH |
/v1/assistants/{assistant_id} |
Patch Assistant |
POST |
/v1/assistants/{assistant_id}/retire |
Retire Assistant |
POST |
/v1/decide |
Decide |
GET |
/v1/decisions |
List Decisions |
provisioning-api — 11 operationer
| Metod | Sökväg | Beskrivning |
|---|---|---|
GET |
/healthz |
Healthz |
GET |
/readyz |
Readyz |
POST |
/v1/assistants/{assistant_id}/activate |
Activate Assistant |
GET |
/v1/tenants |
List Tenants |
POST |
/v1/tenants |
Create Tenant |
GET |
/v1/tenants/{tenant_id} |
Get Tenant |
POST |
/v1/tenants/{tenant_id}/exports |
Trigger Export |
GET |
/v1/tenants/{tenant_id}/exports/{export_id} |
Get Export Status |
GET |
/v1/tenants/{tenant_id}/exports/{export_id}/download |
Download Export |
POST |
/v1/tenants/{tenant_id}/transitions/{action} |
Transition Tenant |
POST |
/v1/webhooks/events |
Receive Event |
rag-api — 16 operationer
| Metod | Sökväg | Beskrivning |
|---|---|---|
GET |
/gdpr/users/{user_id_hash}/authoring/export |
Export Subject Authoring |
GET |
/healthz |
Healthz |
GET |
/readyz |
Readyz |
GET |
/v1/collections |
List Collections |
POST |
/v1/collections |
Create Collection |
GET |
/v1/collections/{collection_id} |
Get Collection |
PATCH |
/v1/collections/{collection_id} |
Patch Collection |
GET |
/v1/collections/{collection_id}/documents |
List Documents |
POST |
/v1/collections/{collection_id}/documents |
Create Document |
DELETE |
/v1/collections/{collection_id}/documents/{doc_id} |
Delete Document |
GET |
/v1/collections/{collection_id}/documents/{doc_id} |
Get Document |
PATCH |
/v1/collections/{collection_id}/documents/{doc_id} |
Patch Document |
GET |
/v1/collections/{collection_id}/documents/{doc_id}/ingest-status |
Ingest Status |
POST |
/v1/collections/{collection_id}/documents/{doc_id}/sections/{anchor}/verify |
Verify Section |
GET |
/v1/collections/{collection_id}/documents/{doc_id}/versions |
List Versions |
POST |
/v1/collections/{collection_id}/query |
Query Collection |