Actualizar Firmante

PUT

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

Actualizar Firmante

Este endpoint permite actualizar la configuración de un firmante ya registrado, incluyendo tiempos de expiración de enlaces y métodos de autenticación (flujos) requeridos para completar la firma.

Autorización

Este recurso está protegido. Debes incluir tu token de acceso en el encabezado de la petición.

Parámetro	Tipo	Descripción	Límites
`Authorization`	string	Token de acceso (Bearer token).	Obligatorio
`Content-Type`	string	Especifica el formato de la petición.	application/json

Authorization

string

Token de acceso (Bearer token).

Límites:Obligatorio

Content-Type

string

Especifica el formato de la petición.

Límites:application/json

Parámetros de la Petición

Campos Obligatorios

Los campos marcados con un asterisco (*) son obligatorios y deben ser proporcionados en la solicitud. Los demás campos son opcionales.

El cuerpo de la petición permite actualizar la configuración de validez y los métodos de seguridad del firmante.

Parámetro	Tipo	Descripción	Límites
`link_expiration`	integer	Tiempo de expiración del enlace generado.	Opcional
`send_link`	boolean	Define si se debe reenviar el enlace al firmante.	Opcional
`flujo`	object	Objeto con los métodos de autenticación (OTPCorreo, OTPSMS, OTPWhatsapp, Biometrico).	Opcional

link_expiration

integer

Tiempo de expiración del enlace generado.

Límites:Opcional

send_link

boolean

Define si se debe reenviar el enlace al firmante.

Límites:Opcional

flujo

object

Objeto con los métodos de autenticación (OTPCorreo, OTPSMS, OTPWhatsapp, Biometrico).

Límites:Opcional

Ejemplos de Implementación

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));

Códigos de Estado

Código	Estado	Descripción
`200`	OK	Firmante actualizado correctamente.
`400`	Bad Request	Error en los parámetros o formato JSON inválido.
`401`	Unauthorized	Token ausente o inválido.
`404`	Not Found	Firmante no encontrado.
`500`	Server Error	Falla interna en los servidores.