http://jsonapi.org/ describes in detail how to handle compound documents in http _responses_. What I'm missing however is creating (POST) compound documents. example: an ecommerce api to create Where you have have orders, with (optionally) order items. I'ld like to have an api to create an order, with its items in one post request. How should this be done ? How to handle ids ? Why this is desirable. - it makes clients simpler. (don't have to test for failures) - it ensures the orders are created atomically. (with its items, or not at all)