Gherkin is supposed to be for expressing human problems in a human-readable form, that also happens to be useful for computers. Using it to specify technical details of APIs (as opposed to, I dunno, writing some code to hit those APIs) seems like a really weird choice.