Saltar al contenido principal
PATCH
@firma-dev/sdk

Autorizaciones

Authorization
string
header
requerido

Clave API para autenticación. Usa tu clave API directamente sin ningún prefijo (por ejemplo, 'your-api-key'). El prefijo Bearer es opcional pero no obligatorio.

Parámetros de ruta

id
string<uuid>
requerido

ID de la Solicitud de Firma

Cuerpo

application/json

Actualizar solo las propiedades de la Solicitud de Firma

name
string

Nuevo nombre para la solicitud de firma

Maximum string length: 255
description
string

Nueva descripción

document
string<byte>

Reemplaza el documento con un nuevo PDF codificado en base64. El número de páginas se extraerá automáticamente.

expiration_hours
integer

Nuevas horas de expiración

Rango requerido: x >= 1
settings
object

Actualizar configuración

language
enum<string> | null

Idioma opcional de los correos para esta solicitud de firma. Cuando se establece, todos los correos dirigidos al firmante (y el formato de fecha) lo utilizan. Omítelo o usa null para volver al idioma predeterminado del espacio de trabajo y luego de la empresa (sin cambios de comportamiento).

Opciones disponibles:
en,
es,
it,
pt,
fr,
de,
el,
ru,
pl

Respuesta

Solicitud de firma actualizada correctamente. La forma de la respuesta depende de lo que se haya actualizado: la actualización de propiedades devuelve {id, name, template_description, document_url, expiration_hours}; la actualización de destinatario devuelve el objeto de destinatario completo; la actualización de campo devuelve el objeto de campo completo. La respuesta puede incluir un campo 'warning' para advertencias de validación de formato de correo electrónico (no bloqueante).

Respuesta al actualizar propiedades

id
string<uuid>
name
string
template_description
string | null
document_url
string<uri>
expiration_hours
integer