gRPC API
AetherFS exposes a public gRPC API under the aetherfs.v1 package. Use it when you need long-lived streams, large binary transfers, or a generated client in a strongly typed language.
Use gRPC when you need:
- streaming file reads and writes
- long-lived message-bus subscriptions
- tarball import and export flows
- source archive uploads
- generated clients in strongly typed languages
Use the HTTP API when you need:
- straightforward JSON request and response flows
- browser-friendly integrations
- an interactive contract explorer at
/api
This section covers the supported gRPC API. Use the services and methods documented here as the contract surface for integrations.
What should I read next?
- Public surface for the generated service and RPC reference derived from the public protobuf contract
- Auth and transport for metadata, scopes, reflection, and transport behavior
- Streaming and binary flows for the gRPC-only and streaming-heavy parts of the API
- Generated clients for stub generation guidance and contract expectations
- Common workflows for end-to-end usage patterns
- grpcurl examples for quick inspection and manual calls