Skip to main content

Public API contracts

This section is for hosted integration usage. It exposes only the public contract surface and omits internal/private afs-server behavior.

Contract artifact​

  • JSON contract (public): /api/public/aetherfs.swagger.json
  • Interactive explorer: /api/openapi

Public surface (summary)​

  • Session lifecycle, health, and metadata APIs
  • File system APIs (read/write/path operations)
  • Knowledge cache and message bus primitives
  • Collaboration and locking APIs
  • Persistence and commit APIs
  • Secrets lookup and storage APIs
  • Observability and audit endpoints
  • Oversight and approval APIs
  • Underlay source and usage reporting APIs

Only supported public methods are included in this contract.

Explore in-browser​

Use the navigation on the right to search by tag, operation, or response type.