Skip to content

fylr Supervisor documentation under For developers (section + management API) - #11

Open
martinrode wants to merge 5 commits into
mainfrom
supervisor-api-docs
Open

fylr Supervisor documentation under For developers (section + management API)#11
martinrode wants to merge 5 commits into
mainfrom
supervisor-api-docs

Conversation

@martinrode

Copy link
Copy Markdown
Contributor

Adds the fylr Supervisor section under For developers > fylr Supervisor > API: an overview page and the full management-API documentation (45 operations as GitBook openapi blocks, driven by the committed OpenAPI 3.0 spec synced from the fylr repo, internal/supervisor/apidocs/).

Spec re-sync also carries the deployments→binaries API replacement, /certs/inspect, and the fleet files_bytes total.

See #76257. Opened by Claude (Fable 5) on behalf of Martin Rode.

🤖 Generated with Claude Code

martinrode and others added 5 commits July 14, 2026 20:51
…ntation

Top-level page supervisor/README.md (what the Supervisor is and centralizes) with the API documentation as its first subpage: one GitBook openapi block per operation (44), driven by the committed OpenAPI 3.0 spec (.gitbook/assets/fylr-supervisor-openapi.yml). The spec is maintained in the fylr repo (internal/supervisor/apidocs/) and copied here — keep both in sync.

see #76257

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Picks up the per-instance hibernation override (hibernate_after /
effective_hibernate_after), the restore-time encryption_key adoption and
the encryption_key_hint view field.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Spherical videos and panoramic images carry a projection_type key in their technical metadata from 6.35.0. Adds the key to both OpenAPI spec assets (surgical edit, no full resync) and a paragraph to the metadata-extraction section explaining the sources and why only the original carries the marker.

see #80367

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…binaries

The Supervisor section moves from top level to FOR DEVELOPERS (for-developers/supervisor/, nav: For developers > fylr Supervisor > API) with asset paths and links adjusted.

The OpenAPI spec is re-synced from the fylr repo (internal/supervisor/apidocs): the deployments API was replaced by the binaries registry (GET /binaries, PUT/DELETE /binaries/{name}), /instances/{id}/activate was removed, /certs/inspect added, and the fleet summary gained files_bytes; the per-operation openapi blocks now cover all 45 operations.

see #76257

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant