Feat ICD: full OpenAPI 3.0.3 kernel spec (160 operations)
Some checks failed
CI/CD / detect-changes (pull_request) Successful in 4s
CI/CD / test-frontend (pull_request) Has been skipped
CI/CD / test-go-pg (pull_request) Failing after 2m26s
CI/CD / test-sqlite (pull_request) Successful in 2m38s
CI/CD / build-and-deploy (pull_request) Has been skipped

Expands the stub openapi.yaml into a complete Interface Control Document
covering every kernel HTTP endpoint. 22 tag groups, 15 reusable component
schemas, inline request/response definitions for all routes. Served at
/api/docs (Swagger UI) and /api/docs/openapi.yaml.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-03-26 20:22:58 +00:00
parent f4512071db
commit 19c1484937
3 changed files with 4149 additions and 42 deletions

View File

@@ -12,6 +12,11 @@ All notable changes to Switchboard Core are documented here.
Settings > Default Surface dropdown.
- `default_surface` global config key (JSON `{"id": "slug"}`)
- Admin settings UI: Default Surface dropdown (extension surfaces only)
- **ICD (API contract)**: Full OpenAPI 3.0.3 spec covering all 160 kernel
endpoints. 22 tag groups (System, Auth, Profile, Workflows, Packages,
Connections, Teams, Groups, Extensions, and Admin subsections). Reusable
component schemas for User, Team, Group, Workflow, Package, Extension, etc.
Served at `/api/docs` (Swagger UI) and `/api/docs/openapi.yaml`.
### Changed