In general, this looks good. Only quibble is that I might consider putting the param physically closer to the "path" and/or "query" params such that it's clear they are related when scanning options. I'd prob put it up under the "path" param.