Method not allowed

method_not_allowed HTTP 405

The path exists but not with this HTTP method. Most of v1 is read-only today; write endpoints are still in development, so a POST or PATCH to a resource that only lists and shows will land here.

How to react to this in code

Switch on the code member — method_not_allowed — which is stable. Do not parse the type URI: it points here, and where "here" is may change.