WIP clarifying the HTTP API