CHAOS / v0.1.0 / API Reference

chaosd HTTP API

chaosd exposes an HTTP/JSON control surface. It is the contract every control surface builds against, and the CLI uses only this API.

In this release the API is served over HTTP/1.1 on a Unix domain socket, not a TCP port. There is no TLS and no authentication on this surface yet. Every data-plane operation returns the kernel read-back as an AppliedState, so responses describe what the kernel actually holds rather than what was requested.

Base URL
http://localhost
Transport
Unix socket · /run/chaosd/chaosd.sock
Auth
None

This reference is compiled from the CHAOS documentation. Response examples are illustrative; the OpenAPI document generated by the running service is the authoritative contract.

System

Daemon version, port bindings, and backend capabilities.

Impairments

Read, apply, and clear the shaping state of each direction.

Statistics

Live qdisc counters for each direction.

Calibration

The stored calibration baseline.