Skip to main content
La API de Tableros te permite crear estructuras de datos flexibles y administrar sus registros. En las rutas de la API, los tableros se identifican como databases.

​
Flujo recomendado

1

Obtén o crea un tablero

Usa Listar tableros para encontrar su databaseId o Crear tablero para iniciar uno nuevo.
2

Define sus campos

Agrega campos con un name y un type. La API genera un fieldId y una key estable para cada campo.
3

Crea registros

Envía los valores dentro de values, usando la key de cada campo como propiedad.
4

Consulta o busca

Lista con paginación por cursor o usa búsqueda para combinar texto, filtros y ordenamiento.

​
Identificadores

Usa fieldKey, no fieldId, como propiedad dentro de values. Obtén ambas en la respuesta del tablero.

​
Esquema y valores

Configurar campos

Define las propiedades específicas de cada type.

Escribir valores

Consulta el formato esperado dentro de values.

​
Autenticación

Incluye tu API key en todas las solicitudes:
Consulta Autenticación si todavía no tienes una clave.

​
Respuestas y errores

Las operaciones devuelven JSON, excepto las respuestas 204, que no incluyen body. El formato de error habitual es:
Los endpoints de archivos usan error:
La API permite eliminar registros y campos. Actualmente no expone una operación para eliminar un tablero completo.

Administración

Listar tableros

Obtén los tableros disponibles para tu integración.

Crear tablero

Crea un tablero para almacenar registros con un esquema flexible.

Consultar tablero

Obtén la definición y los campos de un tablero por ID.

Actualizar tablero

Actualiza el nombre, la descripción o el orden predeterminado de un tablero.

Campos

Crear campo

Agrega una columna al esquema de un tablero.

Tipos y configuración de campos

Propiedades requeridas y opcionales para definir cada tipo de campo.

Actualizar campo

Modifica la configuración editable de un campo.

Reordenar campos

Define el orden de las columnas de un tablero.

Vincular relación bidireccional

Conecta dos campos de relación existentes como un par bidireccional.

Desvincular relación bidireccional

Separa un par de campos de relación sin modificar los valores de los registros.

Eliminar campo

Quita un campo del esquema de un tablero.

Registros

Valores por tipo de campo

Formato de los valores que envías y recibes en los registros.

Listar registros

Recorre los registros de un tablero con paginación por cursor.

Buscar registros

Busca registros por texto, filtros, IDs y ordenamiento.

Crear registro

Agrega una fila de datos a un tablero.

Crear registros en lote

Crea varios registros y recibe resultados por elemento.

Consultar registro

Obtén un registro por su ID.

Actualizar registro

Modifica uno o más valores de un registro.

Actualizar relaciones de un registro

Agrega o quita vínculos de relación de forma segura.

Consultar historial de un registro

Obtén los cambios anteriores de un registro.

Eliminar registro

Elimina permanentemente un registro de un tablero.

Archivos

Subir archivo

Adjunta un archivo a un campo files de un registro.

Desadjuntar archivo

Quita un archivo de un registro y, opcionalmente, lo elimina permanentemente.