note Apis
Designing the Status Endpoint for a Long-Running API
The status endpoint is a contract. Publish a small, stable state vocabulary instead of your internal states, report a failed job as a successful status call, and pick one status code convention and hold it.