Documentation menu
These are pre-release docs from the main branch.

API reference

8 operations in sla. Raw spec: openapi.json.

POST/api/v1/internal/sla/verdict

POST /api/internal/sla/verdict — fire-once application of one ladder step: ledger insert (PK-guarded), breach flip, notification fan-out with preference gates, events + audit, all in ONE transaction.

Request body

SlaVerdictRequest

Responses

StatusDescription
200
GET/api/v1/sla/calendars

GET /api/sla/calendars

Responses

StatusDescription
200

Security: bearer

POST/api/v1/sla/calendars

POST /api/sla/calendars

Request body

CreateCalendarRequest

Responses

StatusDescription
200

Security: bearer

PATCH/api/v1/sla/calendars/{id}

PATCH /api/sla/calendars/{id} — partial update; validates the merged result by re-reading and running domain validation.

Parameters

NameInTypeRequiredDescription
idpathstringYes

Request body

UpdateCalendarRequest

Responses

StatusDescription
200

Security: bearer

DELETE/api/v1/sla/calendars/{id}

DELETE /api/sla/calendars/{id} — detaches policies (FK SET NULL); their embedded calendars keep governing.

Parameters

NameInTypeRequiredDescription
idpathstringYes

Responses

StatusDescription
200

Security: bearer

GET/api/v1/sla/policies

GET /api/sla/policies

Responses

StatusDescription
200

Security: bearer

GET/api/v1/sla/policies/{id}/ladder

GET /api/sla/policies/{id}/ladder — enabled + disabled steps, ordered.

Parameters

NameInTypeRequiredDescription
idpathstringYes

Responses

StatusDescription
200

Security: bearer

PUT/api/v1/sla/policies/{id}/ladder

PUT /api/sla/policies/{id}/ladder — replaces the whole ladder in one tx.

Parameters

NameInTypeRequiredDescription
idpathstringYes

Request body

ReplaceLadderRequest

Responses

StatusDescription
200

Security: bearer