Change document authorizer

Changes the current authorizer of a document. This action can only be performed by the current Authoriser user with Authoriser role or by a user with the role AuthorisationAdministrator

This API resource is only available to Premium APPs.

POST authorization/change-authorizer

Request properties

Property Type Description Optional
DocumentId Guid Document unique ID No
AuthorizerId Guid New Authorizer unique ID. No
Comment string Reason for change comment No

Example request

{
    documentid : "4c525b0d-032a-4212-8f7d-484633f3482a",
    authorizerid : "4c525b0d-032a-4212-8f7d-484633f3482b",
    comment : 'Comment',
   
}

Successful Response

Upon successful operation a 200 status code will be returned.

Error Response

In the case an error occurs an error code will be returned.

Example response

{
    "message": "One or more validation errors occurred.",
    "code": "invalid_request_payload",
    "_metadata":[
        {
            "field": "documentId",
            "message": "error message will be here",
            "code": "error_code_will_be_here"
        }
    ],
    "_moreInfo": "http://developers.basecone.com/lookup/invalid_request_payload"
}
            

Possible error response codes

Status code Error code Details
400 invalid_request_payload Request properties are not valid to perform the requested operation.
400 validation_error Request failed with one or more validation errors (see below). For more information about how to handle validation errors, please consult client side errors section.
401 unauthorized User is not authorized to access the resource.
403 forbidden User has no rights to execute the requested operation.
404 resource_not_found Resource was not found.