OpenAPI spec at /api/docs with a Scalar viewer, opt-in via FEAT_API_DOCS

This commit is contained in:
jarek committed 2026-08-17 09:50:34 +02:00
1 parent ba8670af66
commit da26f7f764
251 files changed
+32497 -66

No files matched your search

@@ -5,6 +5,18 @@ import { auditStack } from '$lib/server/audit';
import { createJobResponse } from '$lib/server/sse';
import type { RequestHandler } from './$types';
/**
* @openapi
* summary: Take a stack down (docker compose down — removes containers, keeps files), asynchronously
* path: name:string! Stack name (from GET /api/stacks)
* query: env:integer Environment id (from GET /api/environments)
* body: {removeVolumes:boolean}
* body-example: {"removeVolumes":false}
* resp-200: {jobId:string!}
* resp-200-desc: Fire-and-forget job id — poll GET /api/jobs/{jobId} for the result. Send "Accept: application/json" (without text/event-stream) to instead block and receive the final {success,output|error} synchronously.
* resp-200-example: {"jobId":"3f9c5b1a-2e4d-4a6f-9b0a-1c7d8e9f0a1b"}
* resp-403: Permission denied, or access denied to this environment
*/
export const POST: RequestHandler = async (event) => {
const { params, url, cookies, request } = event;
const auth = await authorize(cookies);