En values, cada propiedad usa la key del campo. La configuración del campo se envía por separado.
Números
numberFormat no transforma el valor. Con formato percent, por ejemplo, 25 se muestra como 25 %.
Fechas
Usa formatos ISO 8601:
- Solo fecha:
"2026-07-23".
- Fecha y hora:
"2026-07-23T18:30:00-06:00" o "2026-07-24T00:30:00Z".
Incluye un offset o Z cuando envíes hora. dateConfig.includeTime controla la presentación del tablero, pero no cambia la validación de la API.
Selecciones
Puedes enviar el id o la label de una opción. La API almacena y devuelve su id.
Al crear o actualizar registros, upsertEnumOptions: true permite crear las etiquetas que todavía no existen.
Envía un ID para los tipos *_single y un arreglo de IDs para los tipos *_multi.
Para modificar una relación sin reemplazar su valor completo, usa Actualizar relaciones.
Campos reflejados
No envíes valores para campos lookup. La API los calcula al leer el registro:
firstValue y lastValue devuelven un valor.allValues y uniqueValues devuelven un arreglo.
Archivos
No envíes archivos ni URLs directamente en values. Usa Subir archivo.
Al consultar un registro, el campo contiene un arreglo de objetos:
Valores predeterminados
defaultValue aplica al crear un registro cuando omites la key. Está disponible para string, number, boolean, date, enum y enum_multi.
No se aplica al actualizar un registro ni cuando envías la propiedad con null.
required marca el campo como obligatorio en el esquema y en la captura del tablero. Al escribir por API, valida en tu integración que los valores requeridos estén presentes.
