One Touch Sign (OTS)
Helper APIs
Change Signature Type API
9 min
introduction introducing our groundbreaking change signature type api, a powerful tool designed to revolutionize the way you manage digital signatures this api empowers developers and businesses by providing a seamless solution to modify signature types associated with a specific signer id with just a simple input of the signer id and the desired signature type, our change signature type api facilitates effortless customization of signatures, offering flexibility and efficiency in contract authentication processes whether you need to adapt to evolving regulatory requirements or cater to individual preferences, our api ensures a smooth transition, allowing you to tailor the signature experience to meet your unique needs unlock the potential for dynamic and adaptive signature management with our change signature type api, streamlining your contract workflow like never before authentication api authentication is a crucial security process that ensures authorized access to an application programming interface (api) it involves validating the identity of users or systems seeking to interact with the api please use the access token shared with you by your assigned signzy's csm please set the value of the key authorization in the headers to the access token , while making an api call in this way, signzy's system will be able to authenticate you and you will be able to make a successful api call api details the details of the api can be found here sample curl pre production curl location 'https //api preproduction signzy app/api/v3/esign/signer/changesignaturetype' \\ \ header 'authorization ' \\ \ header 'content type application/json' \\ \ data '{ "signerid" " ", "signaturetype" "aadhaaresign faceauth" }' production curl location 'https //api signzy app/api/v3/esign/signer/changesignaturetype' \\ \ header 'authorization ' \\ \ header 'content type application/json' \\ \ data '{ "signerid" " ", "signaturetype" "aadhaaresign faceauth" }' input parameters key description type mandatory/optional signerid id of the signer for which the signature type needs to be changed string mandatory signaturetype the type of signatures the three possible values are aadhaaresign otp , aadhaaresign fingerprint aadhaaresign faceauth string mandatory sample response 200 { "issuccess" true } output parameters field name description type issuccess the status for the updation of the type of signature string sample errors 400 { "name" "error", "message" "signaturetype must be one of \[aadhaaresign otp, aadhaaresign fingerprint, aadhaaresign faceauth]", "reason" "validation error", "type" "bad request", "statuscode" 400 } 400 { "name" "error", "message" "contract expired", "reason" "bad request", "type" "bad request", "statuscode" 400 } 400 { "name" "error", "message" "signerid is required", "reason" "validation error", "type" "bad request", "statuscode" 400 } 400 { "name" "error", "message" "signer already signed cannot change signaturetype", "reason" "bad request", "type" "bad request", "statuscode" 400 } 400 { "name" "error", "message" "signer already signed", "reason" "bad request", "type" "bad request", "statuscode" 400 } 401 { "message" "invalid authentication credentials" } 404 { "name" "error", "message" "signer not found", "reason" "bad request", "type" "not found", "statuscode" 404 } 500 { "error" { "name" "error", "message" "internal server error", "reason" "internal server error", "type" "internal server error", "statuscode" 500 } } error parameters parameter type description name string in case of errors, it will have the value "error" it represents an error message string message for the error reason string reasons for the error type string type of error statuscode string status code of the error error codes error code error message explanation 400 bad request input parameter has a missing required parameter or invalid inputs 401 authorization failed authorization token is invalid 404 not found signer id is not found in the system 500 internal server error internal error at signzy, please reach out to help\@signzy com