stacken.docs

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

stacken.ai ↗

API · 20 operationer

llm-gateway

Genererad ur services/llm-gateway/openapi.json, kontraktsversion 0.1.0. Auth-modell och anropare står i atlasen.

GET /admin/audit

Audit

ParameterITypKrävs
sincequerystring (date-time) | nullnej
untilquerystring (date-time) | nullnej
actorquerystring | nullnej
actionquerystring | nullnej
qquerystring | nullnej
chainquerystring | nullnej
limitqueryintegernej
authorizationheaderstring | nullnej
SvarBeskrivningKropp
200Successful Responseany application/json
422Validation ErrorHTTPValidationError application/json

DELETE /admin/keys/{key_id}

Revoke Key

ParameterITypKrävs
key_idpathstring (uuid)ja
authorizationheaderstring | nullnej
SvarBeskrivningKropp
204Successful Response—
422Validation ErrorHTTPValidationError application/json

PATCH /admin/keys/{key_id}

Patch Key

ParameterITypKrävs
key_idpathstring (uuid)ja
authorizationheaderstring | nullnej

Kropp: PatchKeyRequest application/json

SvarBeskrivningKropp
200Successful Responseobject application/json
422Validation ErrorHTTPValidationError application/json

GET /admin/tenants/{tenant_id}/budget

Get Budget

ParameterITypKrävs
tenant_idpathstring (uuid)ja
authorizationheaderstring | nullnej
SvarBeskrivningKropp
200Successful Responseobject application/json
422Validation ErrorHTTPValidationError application/json

PUT /admin/tenants/{tenant_id}/budget

Set Budget

ParameterITypKrävs
tenant_idpathstring (uuid)ja
authorizationheaderstring | nullnej

Kropp: SetBudgetRequest application/json

SvarBeskrivningKropp
200Successful Responseobject application/json
422Validation ErrorHTTPValidationError application/json

GET /admin/tenants/{tenant_id}/export

Tenant Export

ParameterITypKrävs
tenant_idpathstring (uuid)ja
authorizationheaderstring | nullnej
SvarBeskrivningKropp
200Successful ResponseTenantExport application/json
422Validation ErrorHTTPValidationError application/json

GET /admin/tenants/{tenant_id}/keys

List Keys

ParameterITypKrävs
tenant_idpathstring (uuid)ja
authorizationheaderstring | nullnej
SvarBeskrivningKropp
200Successful Responseobject[] application/json
422Validation ErrorHTTPValidationError application/json

POST /admin/tenants/{tenant_id}/keys

Create Key

ParameterITypKrävs
tenant_idpathstring (uuid)ja
authorizationheaderstring | nullnej

Kropp: CreateKeyRequest application/json

SvarBeskrivningKropp
201Successful Responseobject application/json
422Validation ErrorHTTPValidationError application/json

GET /admin/tenants/{tenant_id}/usage

Tenant Usage

ParameterITypKrävs
tenant_idpathstring (uuid)ja
periodquerystring | nullnej
authorizationheaderstring | nullnej
SvarBeskrivningKropp
200Successful Responseobject application/json
422Validation ErrorHTTPValidationError application/json

GET /admin/tenants/{tenant_id}/usage/by-group

Tenant Usage By Group

ParameterITypKrävs
tenant_idpathstring (uuid)ja
periodquerystring | nullnej
authorizationheaderstring | nullnej
SvarBeskrivningKropp
200Successful Responseobject application/json
422Validation ErrorHTTPValidationError application/json

GET /admin/tenants/{tenant_id}/usage/by-user

Tenant Usage By User

ParameterITypKrävs
tenant_idpathstring (uuid)ja
user_id_hashquerystringja
authorizationheaderstring | nullnej
SvarBeskrivningKropp
200Successful Responseany application/json
422Validation ErrorHTTPValidationError application/json

PUT /admin/tenants/{tenant_id}/webhook

Set Webhook

ParameterITypKrävs
tenant_idpathstring (uuid)ja
authorizationheaderstring | nullnej

Kropp: SetWebhookRequest application/json

SvarBeskrivningKropp
200Successful Responseobject application/json
422Validation ErrorHTTPValidationError application/json

GET /admin/usage/summary

Summary

ParameterITypKrävs
periodquerystring | nullnej
authorizationheaderstring | nullnej
SvarBeskrivningKropp
200Successful Responseobject application/json
422Validation ErrorHTTPValidationError application/json

GET /health

Health

SvarBeskrivningKropp
200Successful Response{ [nyckel]: string | string[] } application/json

GET /health/watchdog

Health Watchdog

SvarBeskrivningKropp
200Successful Responseany application/json

POST /v1/audio/transcriptions

Transcriptions

ParameterITypKrävs
authorizationheaderstring | nullnej

Kropp: Body_transcriptions_v1_audio_transcriptions_post multipart/form-data

SvarBeskrivningKropp
200Successful Responseany application/json
422Validation ErrorHTTPValidationError application/json

POST /v1/chat/completions

Chat Completions

ParameterITypKrävs
authorizationheaderstring | nullnej
SvarBeskrivningKropp
200Successful Responseany application/json
422Validation ErrorHTTPValidationError application/json

POST /v1/embeddings

Embeddings

ParameterITypKrävs
authorizationheaderstring | nullnej
x-knowledge-collection-idheaderstring | nullnej
x-knowledge-information-classheaderstring | nullnej
x-trace-idheaderstring | nullnej
SvarBeskrivningKropp
200Successful Responseany application/json
422Validation ErrorHTTPValidationError application/json

GET /v1/models

List Models

ParameterITypKrävs
authorizationheaderstring | nullnej
SvarBeskrivningKropp
200Successful Responseany application/json
422Validation ErrorHTTPValidationError application/json

POST /v1/rerank

Rerank

ParameterITypKrävs
authorizationheaderstring | nullnej
x-knowledge-collection-idheaderstring | nullnej
x-knowledge-information-classheaderstring | nullnej
x-trace-idheaderstring | nullnej
SvarBeskrivningKropp
200Successful Responseany application/json
422Validation ErrorHTTPValidationError application/json

Scheman

Body_transcriptions_v1_audio_transcriptions_post

FältTypKrävs
filestringja
languagestring | nullnej
modelstringja

CoverageGap

En store exporten INTE täcker, med ett ärligt skäl. `store` måste vara IDENTISK med namnet i `covered` när en store demoteras (t.ex. `page_truncated_over_500`), så en konsument kan korrelera flytten. Se regel (c) i docs/tenant-export-coverage.md.

FältTypKrävs
reasonstringja
storestringja

CreateKeyRequest

FältTypKrävs
allowed_modelsstring[] | nullnej
labelstring | nullnej
purpose"eval" | nullnej

HTTPValidationError

FältTypKrävs
detailValidationError[]nej

PatchKeyRequest

FältTypKrävs
allowed_modelsstring[] | nullja

SetBudgetRequest

FältTypKrävs
alert_thresholdsinteger[] | nullnej
hard_limitboolean | nullnej
monthly_budget_sekstring | nullnej

SetWebhookRequest

FältTypKrävs
webhook_urlstring | nullja

TenantExport

En producents svar. `extra="forbid"` medvetet: bevarar de tre befintliga typade deklarationernas beteende, OCH gör att en producent som lägger ett fält utan att koordinatorn lär sig om det failar högt i stället för tyst.

FältTypKrävs
coverageTenantExportCoverageja
dataobjectja
generated_atstring (date-time)ja
servicestringja
tenant_idstring (uuid)ja

TenantExportCoverage

FältTypKrävs
coveredstring[]ja
not_coveredCoverageGap[]ja

ValidationError

FältTypKrävs
ctxobjectnej
inputanynej
locstring | integer[]ja
msgstringja
typestringja