Include relationships when the client asks for them.
Section: Response shaping
Embed related resources on demand
http
http
GET /orders/ord_123?include=customer,itemsExplanation
Optional includes preserve a lightweight base contract while allowing richer reads.
Learn the surrounding workflow
Compare similar commands or jump into common fixes when this command is part of a bigger troubleshooting path.
Related commands
Same sheet · prioritizing Response shaping
Return an ETag for concurrency and caching
Tag a representation with a revision validator.
Protect updates with If-Match
Prevent lost updates from concurrent writes.
Represent async work as a job resource
Queue work and let clients poll job state.