Re: outline of pools api requests and responses