OpenAPI spec at /api/docs with a Scalar viewer, opt-in via FEAT_API_DOCS
This commit is contained in:
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);
|
||||
|
||||
Reference in new issue
Block a user