stacken.docs

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

stacken.ai ↗

API · 6 operationer

agent-runtime

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

GET /healthz

Healthz

Liveness. Aldrig beroende av nedströms — en trasig dörr ska ge degraderade svar, inte en omstartsloop.

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

GET /readyz

Readyz

Readiness. Databasen prövas i Task 7, när den finns.

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

POST /v1/sessions

Create Session

ParameterITypKrävs
authorizationheaderstring | nullnej

Kropp: SessionCreate application/json

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

DELETE /v1/sessions/{session_id}

Delete Session

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

GET /v1/sessions/{session_id}

Get Session

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

POST /v1/sessions/{session_id}/turns

Run Turn

ParameterITypKrävs
session_idpathstring (uuid)ja
authorizationheaderstring | nullnej

Kropp: TurnRequest application/json

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

Scheman

HTTPValidationError

FältTypKrävs
detailValidationError[]nej

SessionCreate

FältTypKrävs
assistant_idstring (uuid)ja

SessionCreated

FältTypKrävs
expires_atstring (date-time)ja
session_idstring (uuid)ja

SessionRead

FältTypKrävs
assistant_idstring (uuid)ja
created_atstring (date-time)ja
expires_atstring (date-time)ja
session_idstring (uuid)ja

TurnRequest

FältTypKrävs
contentstringja

ValidationError

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