Update Signer

PUT

https://app.firmeasy.legal/api/v1/electronica/firmante/{firmante_id}

Update Signer

This endpoint allows updating the configuration of an already registered signer, including link expiration times and authentication methods (flows) required to complete the signature.

Authorization

This resource is protected. You must include your access token in the request header.

Parameter	Type	Description	Limits
`Authorization`	string	Access token (Bearer token).	Required
`Content-Type`	string	Specifies the request format.	application/json

Authorization

string

Access token (Bearer token).

Limits:Required

Content-Type

string

Specifies the request format.

Limits:application/json

Request Parameters

Required Fields

Fields marked with an asterisk (*) are required and must be provided in the request. Other fields are optional.

The request body allows updating the validity settings and security methods of the signer.

Parameter	Type	Description	Limits
`link_expiration`	integer	Expiration time of the generated link.	Optional
`send_link`	boolean	Defines whether the link should be resent to the signer.	Optional
`flujo`	object	Object with authentication methods (EmailOTP, SMSOTP, WhatsappOTP, Biometric).	Optional

link_expiration

integer

Expiration time of the generated link.

Limits:Optional

send_link

boolean

Defines whether the link should be resent to the signer.

Limits:Optional

flujo

object

Object with authentication methods (EmailOTP, SMSOTP, WhatsappOTP, Biometric).

Limits:Optional

Implementation Examples

cURL

curl -X PUT [https://app.firmeasy.legal/api/v1/electronica/firmante/d14bd81f-edb3-400d-9922-60f1b05ff172](https://app.firmeasy.legal/api/v1/electronica/firmante/d14bd81f-edb3-400d-9922-60f1b05ff172) \
  -H "Authorization: Bearer TU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "link_expiration": 5,
    "send_link": false,
    "flujo": {
        "OTPCorreo": false,
        "OTPSMS": false,
        "OTPWhatsapp": true,
        "Biometrico": false
    }
  }'

Node.js (Fetch)

const myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer TU_TOKEN_AQUI");
myHeaders.append("Content-Type", "application/json");

const raw = JSON.stringify({
  "link_expiration": 5,
  "send_link": false,
  "flujo": {
    "OTPCorreo": false,
    "OTPSMS": false,
    "OTPWhatsapp": true,
    "Biometrico": false
  }
});

const requestOptions = {
  method: "PUT",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("[https://app.firmeasy.legal/api/v1/electronica/firmante/d14bd81f-edb3-400d-9922-60f1b05ff172](https://app.firmeasy.legal/api/v1/electronica/firmante/d14bd81f-edb3-400d-9922-60f1b05ff172)", requestOptions)
  .then((response) => response.json())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

Status Codes

Code	Status	Description
`200`	OK	Signer updated successfully.
`400`	Bad Request	Parameter error or invalid JSON format.
`401`	Unauthorized	Missing or invalid token.
`404`	Not Found	Signer not found.
`500`	Server Error	Internal server failure.