The full wings API reference is now on the site
Every wings endpoint — containers, images, blueprints, tasks, services, functions, terminal, cluster — with curl examples, right on the wings page. Wings itself is marked experimental.
The wings page no longer just links to the docs — the complete
API reference now lives right on it.
The whole API on one page
Seven reference tables cover every endpoint, grouped the way a panel
developer actually uses them:
- System & discovery —
/v1/ping,/healthz,/v1/self,/v1/nodes,
/v1/system/info, /v1/events, /v1/metrics.
- Containers — the full surface: create/inspect/lifecycle,
logs?follow=1
and stats?stream=1 as SSE, exec, the interactive terminal over
websocket (/terminal/ws) and SSE, and the container file browser
(fs/ls|cat|tree, cp).
- Images — list, inspect, Docker Hub search, async pull with progress,
tag, push, remove.
- Blueprints — catalog, detail, async install/uninstall.
- Tasks — poll background jobs, including persisted finished tasks.
- Services & functions — CRUD,
scale,invoke. - Cluster — fleet health, replicas, containers across nodes.
Each table lists method, path and a one-line description, and five curl
examples show the calls end-to-end — from auth and the first /v1/ping to
pulling an image and polling its task, opening a terminal session, and
hitting a specific node with ?node=.
Still experimental — on purpose
Wings is a young project, so the page now says so clearly: the API works and
everything on it is real, but endpoints and payloads can still change between
versions, and it is not recommended for production panels yet. The API
reference is still the best map of where wings is going — it will simply be
kept in sync as the API evolves.
Around the repository
The wings repository also picked up a MIT license, a **contributing
guide and a security policy**, alongside the existing OpenAPI schema,
cluster guide and the automated release pipeline (latest: v0.4.x).
Next up remains the panel itself — a UI that sits on this API.