We should take a look and see if we can improve how LookupArgumentSets are declared in the spec – currently swagger-editor allows both params (e.g. id and permalink) to be sent in the request which triggers an error in Apia.

We should take a look at using a discriminator object such as oneOf which I think should allow us to specify that either the id is sent or the permalink is sent. But not both.