Registro de Cambios de la API REST
Cambios en la API REST v1 (/api/v1/).
2026
2026-07-02
Recurso TemplatePDF — Nuevo endpoint: GET /api/v1/templatepdf/{id}/component-token/ — devuelve un token de componente para el visor para incrustar el componente del visor de PDF.
2026-07-01
Recurso Signer — Nuevo endpoint: GET /api/v1/signer/{id}/component-token/ — devuelve un token de componente para incrustar el componente de firma. Requiere una clave API no heredada y el grupo debe estar habilitado para uso de componentes.
2026-05-20
Recurso Document — Los enlaces de firma para el firmante devueltos en la respuesta de la API ahora se conservan como enlaces en formato heredado para compatibilidad hacia atrás al usar firma en lote/lobby.
2026-04-28
Autenticación — Ahora está disponible un nuevo esquema de clave API. Las claves existentes continúan funcionando. Se recomienda encarecidamente a los desarrolladores actualizar — ver developer.legalesign.com para más detalles.
2026-01-21
Recurso TemplatePDF — DELETE /api/v1/templatepdf/{id}/delete/ — eliminación actualizada para eliminación segura. Devuelve un error si falla (por ejemplo, la política de retención requiere aprobación secundaria).
2026-01-06–07
Recurso Document — Se añadió el campo booleano append_history a la respuesta de envío y detalle del documento. Cuando es true, la página de historial de firma se añade al PDF completado (refleja el comportamiento existente de append_pdf).
Obsoleto: Los campos sign_mouse, sign_type, sign_upload en el recurso documento están obsoletos y serán eliminados en una versión futura.
2025
2025-12-18–19
Recurso Document — Se añadió el parámetro skip para firmantes al enviar un documento. Configurar skip: true en una posición de firmante omite ese destinatario del envío. Los testigos que siguen a un firmante omitido también se omiten automáticamente.
2025-10-30
Recurso Document — La creación de políticas de retención se movió del envío por API al flujo de firma.
2025-10-08
- Recurso Document — La respuesta de
GET /api/v1/document/{id}/ahora incluye un arreglosigner_objectsjunto con el arreglo existentesigners. Cada objeto contiene:firstname,lastname,email,tel,status,order,resource_uri,role,uuid. - Recurso Signer — Se añadió el campo
rolea la respuesta del firmante ("signer","approver"o"witness").
2025-09-26
- Recurso Document —
DELETE /api/v1/document/{id}/— se añadió el parámetro opcionalemail=1en la query para enviar correos de notificación al eliminar. - Recurso TemplatePDF — Se añadió el parámetro
hide_sender_fieldsal endpoint de edición de PDF. - Recurso Element/Field — Las búsquedas
pdftextysignertextahora aceptan UUID además del nombre de etiqueta. - Recurso Signer — Se añadió el campo
uuidal objeto de respuesta del firmante.
2025-09-04
Recurso Document — Cuando no se proporciona mensaje en el envío, ahora se usa automáticamente la plantilla de mensaje predeterminada del grupo.
2025-08-22
Recurso Document — Al enviar un documento, el PDF fuente ahora se copia de la plantilla al registro del documento.
2025-06-10
Recurso TemplatePDF — Nuevo endpoint: POST /api/v1/templatepdf/{id}/archive/ — archiva un PDF de plantilla.
2024
2024-10-17
Recurso Document — Se eliminó el parámetro de firmante obsoleto append_to. Este parámetro no tenía efecto y ha sido eliminado.
2024-08-21
- Recurso User — Los usuarios creados por la API ahora reciben una contraseña permanente (no una temporal que requiera restablecimiento).
- Recurso Document — Valores firmantes de elementos administrativos manejados correctamente para índice de firmante 0.
2024-08-20
- Recurso Document — Los parámetros
convert_sender_to_signerystrict_fieldsahora aceptantrue/"true"/1(antes sólo booleanoTrue). - Recurso Signer/Element — El campo
signerahora puede ser nulo; los elementos conelement_type: "admin"tienen como valor predeterminado el firmante0. - Roles — Los roles de API se sincronizan con la consola después de la creación del documento.
- Mensajes de error — Mejora en el error cuando el usuario no tiene enlace con organización.
2024-08-19
Recurso Group (Tab) — POST /api/v1/group/ — name es ahora el único campo requerido. xframe_allow es un parámetro opcional.
2024-07-16
Recurso Document — El parámetro cc ahora acepta el valor "default" para usar la lista de CC de correo predeterminada del grupo.
2024-06-14
Recurso Document — Se añadieron los campos pdf_password y pdf_password_type a la respuesta de detalle de documento.
2024-02-20
Recurso TemplatePDF — GET /api/v1/templatepdf/{id}/ (descarga de PDF) — se añadió el parámetro de consulta returnAsJson para devolver el PDF como respuesta JSON codificada en base64 en lugar de una descarga de archivo.
2024-02-09
Recurso TemplatePDF — Corregido error tipográfico en la respuesta returnAsJson: documet_uri → document_uri.
2024-01-26
Recurso TemplatePDF — POST /api/v1/templatepdf/ — se añadió el parámetro de consulta opcional returnAsJson. Cuando está establecido, el cuerpo de la respuesta incluye { resource: { uid, status_uri, document_uri } } en lugar de un 201 vacío.
2024-01-21
Recurso Document — Mejora de rendimiento: GET /api/v1/document/ actualizado (consulta de conteo más rápida).
2023
2023-09-27
Recurso Document — GET /api/v1/document/ — se añadieron dos nuevos parámetros de filtro en consulta:
created_gt— filtrar documentos creados después de una fecha y hora dada (ISO 8601)modified_gt— filtrar documentos modificados después de una fecha y hora dada (ISO 8601)
Las URLs de paginación next/previous ahora incluyen correctamente todos los parámetros de filtro activos.
2023-08-08
Recurso Document — GET /api/v1/document/ — añadido parámetro de filtro sentUserId.
2023-07-07
Recurso User — Los usuarios administradores ahora pueden crear subusuarios vía API.
2023-05-31
Recurso Document — Los testigos ya no se incluyen en la lista predeterminada de destinatarios de recordatorios.
2023-04-17
- Recurso Signer — Se añadió el campo
rejection_reasona la respuesta del firmante. - Nomenclatura — Correcciones de consistencia en el nombrado de campos en toda la API.
2023-03-02
Webhooks — La longitud máxima del campo callback_url se extendió de 200 a 500 caracteres.
2023-01-17
Recurso Document — Se añadieron los campos tag2 y tag3 (además de los existentes tag/tag1) al envío de documentos y respuesta.
2022
2022-11-14–15
Recurso Document — Se aumentó el número máximo de campos permitidos por documento.
2022-11-02–03
Webhooks — Se añadieron nuevos tipos de eventos webhook. Actualizados ítems usercallback.
2022-09-09
Recurso Document — Añadido parámetro de solicitud message_template para especificar una plantilla de mensaje al enviar.
2022-05-12
Recurso Element/Field — Se añadió el campo no_pdf: opción para marcar un campo para que no se renderice en el PDF final.
2022-04-20
- Recurso Document —
roleya no es requerido en el diccionario de firmante al enviar un documento usando un TemplatePDF. - Reporte de errores — Mejoras en mensajes de error en toda la API.
2022-04-06
Recurso Element/Field — Añadido tipo de validación regex (tipo de validación 93) para valores de campo.
2022-02-24
Recurso Element/Field — Añadido campo label_extra.
2022-02-22
Recurso TemplatePDF — Añadida opción force_download en la obtención de borradores de PDF.
2022-02-17
Recurso Document — Añadido soporte para reviewers al enviar un documento.
2022-02-15
Recurso Document — Añadido soporte para campo honorifics en el POST de documento.
2021
2021-11-30
Recurso Document — Nuevo endpoint: GET /api/v1/document/{id}/auditlog/ — devuelve el registro de auditoría de un documento.
2021-10-31
Recurso Document — La respuesta de GET /api/v1/document/ ahora incluye el campo tag.
2021-10-30
Recurso Document — La respuesta de GET /api/v1/document/ ahora incluye el campo location.
2021-10-28
Recurso Document — Soporte añadido para validación de campos al enviar documentos vía API.
2021-10-27
Recurso Document — Nuevo endpoint: GET /api/v1/document/{id}/fields/ — devuelve datos de campos para un documento.
2021-10-25
Recurso Document — Soporte añadido para bundle. Añadido parámetro convert_sender_to_signer al enviar un documento.
2021-08-17
Recurso TemplatePDF — Añadido campo archive_upon_send a la lista de campos del recurso TemplatePDF.