205

Reset Content

2xx Success

Back to list

Server perspective

Use 205 when the request succeeded and the user agent should reset the document view that submitted it.

When to use

  • Return 205 for data-entry workflows where the next sensible step is a clean input state
  • Use it sparingly when the reset behavior is part of the product contract

How to respond

  • Do not include a response body
  • Make sure the client experience is designed to handle the reset intentionally

Headers to consider

  • No status-specific header is required for the reset signal.

Response body

  • Do not include a response body in a 205 response

Server-side pitfalls

  • Do not depend on generic browsers magically clearing complex application UI for you
  • Use 204 instead when success is enough and reset behavior is not part of the contract

Examples

Repeated data entry form

Request:POST /inventory/scan
Response:205 Reset Content

The server signals success and indicates the UI should be reset for the next scan.

References

Related 2xx Success Codes