stacken.docs

Styrning för en växande portfölj av AI-tjänster

stacken.ai ↗

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