{"id":"http-methods-post","title":"POST","section":"http-methods","useCases":["Creating new resources in a collection","Triggering actions on resources","Operations that are not idempotent"],"rules":[{"requirement":"SHOULD","rule":"Return 201 Created for resource creation"},{"requirement":"SHOULD","rule":"Include Location header with new resource URL"},{"requirement":"MAY","rule":"Return 202 Accepted for async operations"}],"examples":[{"description":"Create a resource","request":{"method":"POST","path":"/v1/orders","body":{"customerId":"123","items":[]}},"response":{"status":201,"headers":{"Location":"/v1/orders/456"}}},{"description":"Trigger an action","request":{"method":"POST","path":"/v1/orders/456/actions/cancel"},"response":{"status":200}}]}