Queue work and let clients poll job state.
Section: Response shaping
Represent async work as a job resource
json
json
{
"id": "job_123",
"status": "queued",
"url": "/jobs/job_123"
}Explanation
This pattern works well when a request takes too long to finish within a normal synchronous response window.
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
Embed related resources on demand
Include relationships when the client asks for them.
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.