An Action resource is a hypermedia control that triggers a state change. They act like buttons to execute an action on the server. Actions do not accept a payload; the URL contains all the Action’s identifying information.
The Action profile presents the required
Clients trigger an Action by
POSTing to it. The resource responds with
204 No Content and the
Location header points to the state that was changed by the triggered action. The resource returns a
409 Conflict status if the action cannot be completed because the system state will not accept it.
The Representation profile mixin enables the client to receive the target representation in the Action response.
HTTP/1.1 Semantics and Content: RFC 7231
Copyright © 2019 Matt Bishop
This work is licensed under a Creative Commons Attribution-NoDerivatives 4.0 International License.