doc: update agent-api-v0

(Re)-add PUT/replace endpoint spec.
agent: add Replace method to interface
doc: agent-api-v0: more response code clarity
scheduler: mock agent properly implements Agent interface