Saltar al contenido principal
PUT
@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

workspace_id
string<uuid>
requerido

Cuerpo

application/json
signing_request_email_header
string
signing_request_email_body
string
team_email
string<email>
timezone
string
language
enum<string>

Idioma del espacio de trabajo para las plantillas de correo

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

Si se debe mostrar el costo en créditos en los editores incrustados

require_otp_verification
boolean | null

Si los firmantes deben verificar su correo mediante OTP. null = heredar de la empresa

require_terms_acceptance
boolean | null

Si los firmantes deben aceptar los términos antes de firmar. null hereda la configuración a nivel de empresa.

disable_guided_navigation
boolean | null

Desactiva el desplazamiento automático al siguiente campo requerido durante la firma. Hereda del espacio de trabajo o de la empresa si no se establece.

show_signature_frame
boolean | null

Si se deben renderizar los marcos de firma en los PDF completados. null = heredar de la empresa

color_primary
string | null

Color primario personalizado (hex #rrggbb). Null para heredar de la empresa.

color_primary_fg
string | null

Anulación del color de primer plano primario. Null para heredar de la empresa.

color_background
string | null

Anulación del color de fondo. Null para heredar de la empresa.

color_foreground
string | null

Anulación del color de primer plano/texto. Null para heredar de la empresa.

color_card
string | null

Anulación del color de fondo de la tarjeta. Null para heredar de la empresa.

color_border
string | null

Anulación del color del borde. Null para heredar de la empresa.

color_accent
string | null

Color de acento de la interfaz del editor. Null para heredar de la empresa.

color_accent_fg
string | null

Color de primer plano en superficies de acento. Null para heredar de la empresa.

color_canvas
string | null

Color del entorno del lienzo del documento en el editor. Null para heredar de la empresa.

color_muted
string | null

Color de superficie atenuado. Null para heredar de la empresa.

color_muted_fg
string | null

Color de texto atenuado. Null para heredar de la empresa.

email_local_part
string | null

La parte local (antes del @) de la dirección de correo del remitente. Null para heredar de la configuración de la empresa.

Required string length: 1 - 64
Pattern: ^[a-z0-9]([a-z0-9._-]*[a-z0-9])?$
allow_presigning_download
boolean | null

Permite a los firmantes descargar el documento original antes de firmar. Hereda de la configuración del espacio de trabajo o de la empresa cuando es null.

show_partial_watermark
boolean | null

Muestra una marca de agua de EN PROGRESO en las descargas parciales de PDF cuando no todos los firmantes han completado. null hereda la configuración a nivel de empresa.

show_qr_code
boolean | null

Muestra un código QR en la página de firma que permite a los firmantes continuar desde su teléfono. Hereda de la configuración del espacio de trabajo o de la empresa cuando es null.

signing_button_label_overrides
object | null

Etiquetas de botón personalizadas por idioma para la vista de firma. Las claves son códigos de idioma (en, de, etc.); los valores son objetos que mapean claves de traducción a texto personalizado. Null para usar los valores predeterminados.

Respuesta

Configuración del espacio de trabajo actualizada correctamente

workspace_id
string<uuid>
requerido
name
string

Nombre del espacio de trabajo

team_email
string<email>

Correo electrónico de contacto del espacio de trabajo

timezone
string

Zona horaria del espacio de trabajo

language
enum<string>
predeterminado:en

Idioma del espacio de trabajo para las plantillas de correo electrónico

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

Texto de encabezado de correo electrónico personalizado

signing_request_email_body
string

Cuerpo de correo electrónico HTML personalizado

show_credit_cost_in_editor
boolean
predeterminado:true

Indica si se debe mostrar el costo en créditos en los editores incrustados de plantillas y solicitudes de firma

require_otp_verification
boolean | null

Indica si los firmantes deben verificar su correo electrónico mediante OTP antes de acceder a los documentos. null = heredar de la configuración de la empresa, true = requerir OTP, false = no requerir OTP

require_terms_acceptance
boolean | null

Indica si los firmantes deben aceptar los términos antes de firmar. null hereda la configuración a nivel de empresa.

disable_guided_navigation
boolean | null

Desactiva el desplazamiento automático hacia el siguiente campo requerido durante la firma. Hereda del espacio de trabajo o de la empresa si no está definido.

show_signature_frame
boolean | null

Indica si se debe mostrar un marco visual con el ID de Firma alrededor de las firmas en los PDF completados. null = heredar de la configuración de la empresa (habilitado por defecto), true = mostrar marco, false = ocultar marco

allow_presigning_download
boolean | null

Permite a los firmantes descargar el documento original antes de firmar. null hereda la configuración a nivel de empresa.

show_partial_watermark
boolean | null

Muestra una marca de agua de EN PROGRESO en las descargas parciales del PDF cuando no todos los firmantes han completado el proceso. null hereda la configuración a nivel de empresa.

show_qr_code
boolean | null

Muestra un código QR en la página de firma que permite a los firmantes continuar desde su teléfono. null hereda la configuración a nivel de empresa.

color_primary
string | null

Anulación del color primario (hex #rrggbb). Null para heredar de la empresa.

Ejemplo:

"#2563eb"

color_primary_fg
string | null

Anulación del color primario de primer plano. Null para heredar.

Ejemplo:

"#ffffff"

color_background
string | null

Anulación del color de fondo. Null para heredar.

Ejemplo:

"#0f172a"

color_foreground
string | null

Anulación del color de primer plano/texto. Null para heredar.

Ejemplo:

"#ffffff"

color_card
string | null

Anulación del color de fondo de las tarjetas. Null para heredar.

Ejemplo:

"#22222a"

color_border
string | null

Anulación del color del borde. Null para heredar.

Ejemplo:

"#3b3b3b"

color_accent
string | null

Color de acento de la interfaz del editor. Null para heredar.

Ejemplo:

"#34eeff"

color_accent_fg
string | null

Color de primer plano en superficies de acento. Null para heredar.

Ejemplo:

"#000000"

color_canvas
string | null

Color del entorno del lienzo de documento del editor. Null para heredar.

Ejemplo:

"#0f1419"

color_muted
string | null

Color de superficie atenuado. Null para heredar.

Ejemplo:

"#22222a"

color_muted_fg
string | null

Color de texto atenuado. Null para heredar.

Ejemplo:

"#b8b8b8"

email_local_part
string | null

La parte local (antes de la @) de la dirección de correo del remitente. Null para heredar de la configuración de la empresa. Solo aplica cuando hay un dominio personalizado verificado configurado.

Required string length: 1 - 64
Pattern: ^[a-z0-9]([a-z0-9._-]*[a-z0-9])?$
Ejemplo:

"signatures"

signing_button_label_overrides
object | null

Etiquetas de botón personalizadas por idioma para la vista de firma. Las claves son códigos de idioma (en, de, etc.); los valores son objetos que asignan claves de traducción a texto personalizado. Null para usar los valores predeterminados.