The operation method should be only defined in the request method and the list of ids to delete should be defined in a proper instances parameter. Every HTTP method can accept URL parameters (including PUT and DELETE).
Just a quick note, I would suggest we use members as the parameter instead of instances. Members is the name given to items in the collection, so that seems more appropriate.
I'm submitting a
[x] bug report.
Current Behaviour:
As discussed in the confcall, the current API semantics for operations on collections is far from being conventional:
Two major points:
Expected Behaviour:
The correct semantics should be
The operation method should be only defined in the request method and the list of ids to delete should be defined in a proper
instances
parameter. Every HTTP method can accept URL parameters (including PUT and DELETE).