Back to Change

An authorization can be brought back into the "Change" status by the "Back to Change" operation. The "Back to Change" operation is available for authorizations in the status "Pended".

When an authorization is in pended status, an addition link is added to the resource representation:

 ... authorizarion properties ...
 "links": [
    {
      "href": "http://<host>:<port>/api/generic/authorizations/<id>",
      "rel": "self"
    },
    {
      "href": "http://<host>:<port>/api/authorizations/<authorization id>/tochange",
      "rel": "authorization:tochange",
      "httpMethod": "POST"
    }
  ]
}

Calling POST on this link will bring an authorization in the "Change" status. HTTP Status 200 is returned together with a resource representation of the updated authorization.

Authorization

This operation is protected by access restriction "authorizations.tochange IP". Read grant must also be given to the access restriction "authorizations API".

Response Message

Success

HTTP 303 SEE OTHER after the operation is completed successfully, request is redirected to authorizations API.

Failure

Response	Description
HTTP 401	Unauthorized
HTTP 404	Authorization is unknown
HTTP 409	Authorization is not in pended status.

Please refer to the 'Response Messages' section in the HTTP API Integration Points part of the Common Features book for more details.