Explaining what the API will look like make sense to me.  I think it would go well near the "This involves implementing a multi-step request pipeline involving steps on both the remote service and the client" section