comment: updating api specification (diffs become files)