Bases de datos

Endpoints de Bases de datos (Waiify DB): tablas propias con columnas tipadas para inventarios, catálogos y cualquier dato estructurado de tu negocio. Todos cuelgan de /workspaces/:workspaceId/databases y requieren autenticación.

Consejo

Jerarquía del recurso: una base de datos contiene tablas, cada tabla tiene columnas tipadas y filas. El nodo Database de Flow Studio usa exactamente estos mismos endpoints.

Bases de datos

Método	Ruta	Descripción
GET	/databases	Listar bases de datos
POST	/databases	Crear base de datos
GET	/databases/:dbId	Obtener base de datos
PATCH	/databases/:dbId	Actualizar base de datos
DELETE	/databases/:dbId	Eliminar base de datos

Tablas

Método	Ruta	Descripción
GET	/databases/:dbId/tables	Listar tablas de una base
POST	/databases/:dbId/tables	Crear tabla (opcionalmente con sus columnas)
GET	/databases/:dbId/tables/:tableId	Obtener tabla (con sus columnas)
PATCH	/databases/:dbId/tables/:tableId	Actualizar tabla (nombre visible y descripción)
DELETE	/databases/:dbId/tables/:tableId	Eliminar tabla

Columnas

Método	Ruta	Descripción
POST	/databases/:dbId/tables/:tableId/columns	Crear columna
PATCH	/databases/:dbId/tables/:tableId/columns/:colId	Actualizar columna
DELETE	/databases/:dbId/tables/:tableId/columns/:colId	Eliminar columna

Filas

Método	Ruta	Descripción
GET	/databases/:dbId/tables/:tableId/rows	Listar filas (con búsqueda, filtros y orden)
POST	/databases/:dbId/tables/:tableId/rows	Crear fila
GET	/databases/:dbId/tables/:tableId/rows/:rowId	Obtener fila
PATCH	/databases/:dbId/tables/:tableId/rows/:rowId	Actualizar fila (merge parcial)
DELETE	/databases/:dbId/tables/:tableId/rows/:rowId	Eliminar fila (borrado lógico)
POST	/databases/:dbId/tables/:tableId/rows/query	Operación sobre filas: upsert, aggregate o deleteMany
POST	/databases/:dbId/tables/:tableId/import	Importar filas en lote

Precaución

Las rutas de escritura de filas (crear, actualizar, eliminar, query, import) tienen rate limit propio: 120 peticiones por minuto por IP, además de los rate limits generales de la API.

---

Crear base de datos

POST /workspaces/:workspaceId/databases Copiar

Cuerpo de la petición

Campo	Tipo	Requerido	Descripción
name	string	Sí	Nombre de la base de datos.
description	string	No	Descripción.
driver	string	No	Solo admite "waiify-pg" (por defecto).
color	string	No	Color para identificarla en la biblioteca.
icon	string	No	Icono asociado.

cURL

curl -X POST "https://api.waiify.com/workspaces/WORKSPACE_ID/databases" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Inventario", "description": "Stock de productos por sucursal" }'

Node

const res = await fetch(
  'https://api.waiify.com/workspaces/WORKSPACE_ID/databases',
  {
    method: 'POST',
    headers: {
      Authorization: 'Bearer TU_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      name: 'Inventario',
      description: 'Stock de productos por sucursal',
    }),
  }
);

const { data: database } = await res.json();

Python

import requests

res = requests.post(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/databases",
    headers={"Authorization": "Bearer TU_API_KEY"},
    json={"name": "Inventario", "description": "Stock de productos por sucursal"},
)

database = res.json()["data"]

Respuesta 201

{
  "success": true,
  "data": {
    "id": "wdb_ab12cd34ef",
    "workspaceId": "ws_ab12cd34ef",
    "name": "Inventario",
    "description": "Stock de productos por sucursal",
    "driver": "waiify-pg",
    "color": null,
    "icon": null,
    "createdAt": "2026-06-18T09:00:00.000Z",
    "updatedAt": "2026-06-18T09:00:00.000Z"
  }
}

Crear tabla

POST /workspaces/:workspaceId/databases/:dbId/tables Copiar

Cuerpo de la petición

Campo	Tipo	Requerido	Descripción
name	string	Sí	Identificador interno de la tabla (empieza con letra; letras, números y guion bajo). Único dentro de la base.
displayName	string	Sí	Nombre visible.
description	string	No	Descripción.
columns	array	No	Columnas iniciales (mismo formato que crear columna). Una tabla admite hasta 50 columnas.

cURL

curl -X POST "https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "productos",
    "displayName": "Productos",
    "columns": [
      { "key": "nombre", "displayName": "Nombre", "type": "text", "required": true },
      { "key": "precio", "displayName": "Precio", "type": "currency" },
      { "key": "stock", "displayName": "Stock", "type": "number", "unique": false }
    ]
  }'

Node

const res = await fetch(
  'https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables',
  {
    method: 'POST',
    headers: {
      Authorization: 'Bearer TU_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      name: 'productos',
      displayName: 'Productos',
      columns: [
        { key: 'nombre', displayName: 'Nombre', type: 'text', required: true },
        { key: 'precio', displayName: 'Precio', type: 'currency' },
        { key: 'stock', displayName: 'Stock', type: 'number' },
      ],
    }),
  }
);

const { data: table } = await res.json();

Python

import requests

res = requests.post(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables",
    headers={"Authorization": "Bearer TU_API_KEY"},
    json={
        "name": "productos",
        "displayName": "Productos",
        "columns": [
            {"key": "nombre", "displayName": "Nombre", "type": "text", "required": True},
            {"key": "precio", "displayName": "Precio", "type": "currency"},
            {"key": "stock", "displayName": "Stock", "type": "number"},
        ],
    },
)

table = res.json()["data"]

Respuesta 201

{
  "success": true,
  "data": {
    "id": "tbl_ab12cd34ef",
    "databaseId": "wdb_ab12cd34ef",
    "workspaceId": "ws_ab12cd34ef",
    "name": "productos",
    "displayName": "Productos",
    "description": null,
    "columns": [
      { "id": "col_1", "key": "nombre", "displayName": "Nombre", "type": "text", "required": true, "unique": false, "indexed": false, "position": 0 },
      { "id": "col_2", "key": "precio", "displayName": "Precio", "type": "currency", "required": false, "unique": false, "indexed": false, "position": 1 },
      { "id": "col_3", "key": "stock", "displayName": "Stock", "type": "number", "required": false, "unique": false, "indexed": false, "position": 2 }
    ],
    "createdAt": "2026-06-18T09:00:00.000Z"
  }
}

Crear columna

POST /workspaces/:workspaceId/databases/:dbId/tables/:tableId/columns Copiar

Cuerpo de la petición

Campo	Tipo	Requerido	Descripción
key	string	Sí	Identificador interno (empieza con letra; letras, números y guion bajo). Único dentro de la tabla.
displayName	string	Sí	Nombre visible.
type	string	Sí	Uno de: text, longText, number, currency, boolean, date, datetime, select, multi_select, email, phone, url, json, reference.
required	boolean	No	Por defecto false.
unique	boolean	No	Por defecto false.
indexed	boolean	No	Por defecto false.
defaultValue	any	No	Valor por defecto al crear una fila sin ese campo.
options	object	No	Depende del tipo: choices (arreglo de strings, para select/multi_select), precision (decimales, para number/currency), refTableId + refColumnKey (para reference).

cURL

curl -X POST "https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/columns" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "categoria",
    "displayName": "Categoría",
    "type": "select",
    "options": { "choices": ["Electrónica", "Ropa", "Hogar"] }
  }'

Node

await fetch(
  'https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/columns',
  {
    method: 'POST',
    headers: {
      Authorization: 'Bearer TU_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      key: 'categoria',
      displayName: 'Categoría',
      type: 'select',
      options: { choices: ['Electrónica', 'Ropa', 'Hogar'] },
    }),
  }
);

Python

import requests

requests.post(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/columns",
    headers={"Authorization": "Bearer TU_API_KEY"},
    json={
        "key": "categoria",
        "displayName": "Categoría",
        "type": "select",
        "options": {"choices": ["Electrónica", "Ropa", "Hogar"]},
    },
)

Respuesta 201

{
  "success": true,
  "data": {
    "id": "col_4",
    "tableId": "tbl_ab12cd34ef",
    "key": "categoria",
    "displayName": "Categoría",
    "type": "select",
    "required": false,
    "unique": false,
    "indexed": false,
    "defaultValue": null,
    "options": { "choices": ["Electrónica", "Ropa", "Hogar"] },
    "position": 3
  }
}

Listar filas

GET /workspaces/:workspaceId/databases/:dbId/tables/:tableId/rows Copiar

Parámetros de query

Parámetro	Tipo	Descripción
search	string	Búsqueda libre sobre los valores de la fila. Se combina en AND con filter.
filter	string (JSON)	Filtro estructurado — ver formato abajo.
sort	string (JSON)	Arreglo de orden — ver formato abajo.
page	number	Página, empieza en 1.
pageSize	number	Filas por página. Por defecto 50, tope 1000.

filter es un JSON con esta forma (hasta 50 condiciones):

Formato de filter

{
  "combinator": "and",
  "conditions": [
    { "column": "categoria", "operator": "eq", "value": "Electrónica" },
    { "column": "stock", "operator": "gt", "value": 0 }
  ]
}

Operadores disponibles: eq, ne, gt, gte, lt, lte, contains, startsWith, endsWith, isEmpty, isNotEmpty, in.

sort es un arreglo de { "column": "...", "direction": "asc" | "desc" }.

Precaución

La respuesta de este endpoint no sigue el sobre estándar { data, pagination } del resto de la API: los campos vienen sueltos como { success, rows, total, page, pageSize }.

cURL

curl -G "https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/rows" \
  -H "Authorization: Bearer TU_API_KEY" \
  --data-urlencode 'filter={"combinator":"and","conditions":[{"column":"stock","operator":"gt","value":0}]}' \
  --data-urlencode 'sort=[{"column":"nombre","direction":"asc"}]' \
  --data-urlencode 'pageSize=20'

Node

const params = new URLSearchParams({
  filter: JSON.stringify({
    combinator: 'and',
    conditions: [{ column: 'stock', operator: 'gt', value: 0 }],
  }),
  sort: JSON.stringify([{ column: 'nombre', direction: 'asc' }]),
  pageSize: '20',
});

const res = await fetch(
  `https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/rows?${params}`,
  { headers: { Authorization: 'Bearer TU_API_KEY' } }
);

const { rows } = await res.json();

Python

import json
import requests

res = requests.get(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/rows",
    headers={"Authorization": "Bearer TU_API_KEY"},
    params={
        "filter": json.dumps({"combinator": "and", "conditions": [{"column": "stock", "operator": "gt", "value": 0}]}),
        "sort": json.dumps([{"column": "nombre", "direction": "asc"}]),
        "pageSize": 20,
    },
)

rows = res.json()["rows"]

Respuesta 200

{
  "success": true,
  "rows": [
    {
      "id": "row_ab12cd34ef",
      "nombre": "Audífonos inalámbricos",
      "precio": 899.0,
      "stock": 12,
      "categoria": "Electrónica",
      "_createdAt": "2026-06-18T09:00:00.000Z",
      "_updatedAt": "2026-06-18T09:00:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 20
}

Obtener fila

GET /workspaces/:workspaceId/databases/:dbId/tables/:tableId/rows/:rowId Copiar

cURL

curl "https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/rows/ROW_ID" \
  -H "Authorization: Bearer TU_API_KEY"

Node

const res = await fetch(
  'https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/rows/ROW_ID',
  { headers: { Authorization: 'Bearer TU_API_KEY' } }
);

const { data: row } = await res.json();

Python

import requests

res = requests.get(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/rows/ROW_ID",
    headers={"Authorization": "Bearer TU_API_KEY"},
)

row = res.json()["data"]

Respuesta 200

{
  "success": true,
  "data": {
    "id": "row_ab12cd34ef",
    "nombre": "Audífonos inalámbricos",
    "precio": 899.0,
    "stock": 12,
    "categoria": "Electrónica",
    "_createdAt": "2026-06-18T09:00:00.000Z",
    "_updatedAt": "2026-06-18T09:00:00.000Z"
  }
}

Respuesta 400 — no existe

{ "success": false, "message": "Fila no encontrada" }

Crear fila

POST /workspaces/:workspaceId/databases/:dbId/tables/:tableId/rows Copiar

Cuerpo de la petición

Campo	Tipo	Requerido	Descripción
data	object	Sí	Par columna: valor para cada campo. Los campos omitidos toman el defaultValue de su columna cuando existe; las columnas required sin valor ni default rechazan la petición.

Consejo

La fila creada devuelve sus columnas aplanadas en el objeto (no anidadas bajo data), más id, _createdAt y _updatedAt.

cURL

curl -X POST "https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/rows" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "data": { "nombre": "Mochila urbana", "precio": 549.0, "stock": 30, "categoria": "Ropa" } }'

Node

const res = await fetch(
  'https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/rows',
  {
    method: 'POST',
    headers: {
      Authorization: 'Bearer TU_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      data: { nombre: 'Mochila urbana', precio: 549.0, stock: 30, categoria: 'Ropa' },
    }),
  }
);

const { data: row } = await res.json();

Python

import requests

res = requests.post(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/rows",
    headers={"Authorization": "Bearer TU_API_KEY"},
    json={"data": {"nombre": "Mochila urbana", "precio": 549.0, "stock": 30, "categoria": "Ropa"}},
)

row = res.json()["data"]

Respuesta 201

{
  "success": true,
  "data": {
    "id": "row_bc23de45fg",
    "nombre": "Mochila urbana",
    "precio": 549.0,
    "stock": 30,
    "categoria": "Ropa",
    "_createdAt": "2026-06-18T09:05:00.000Z",
    "_updatedAt": "2026-06-18T09:05:00.000Z"
  }
}

Actualizar fila

PATCH /workspaces/:workspaceId/databases/:dbId/tables/:tableId/rows/:rowId Copiar

Cuerpo de la petición

Campo	Tipo	Requerido	Descripción
data	object	Sí	Par columna: valor a actualizar. Es un merge parcial: las columnas que no envíes conservan su valor actual.

cURL

curl -X PATCH "https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/rows/ROW_ID" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "data": { "stock": 25 } }'

Node

await fetch(
  'https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/rows/ROW_ID',
  {
    method: 'PATCH',
    headers: {
      Authorization: 'Bearer TU_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ data: { stock: 25 } }),
  }
);

Python

import requests

requests.patch(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/rows/ROW_ID",
    headers={"Authorization": "Bearer TU_API_KEY"},
    json={"data": {"stock": 25}},
)

Respuesta 200

{
  "success": true,
  "data": {
    "id": "row_bc23de45fg",
    "nombre": "Mochila urbana",
    "precio": 549.0,
    "stock": 25,
    "categoria": "Ropa",
    "_createdAt": "2026-06-18T09:05:00.000Z",
    "_updatedAt": "2026-06-18T09:10:00.000Z"
  }
}

Eliminar fila

DELETE /workspaces/:workspaceId/databases/:dbId/tables/:tableId/rows/:rowId Copiar

Es un borrado lógico (deletedAt): la fila deja de aparecer en listados y lecturas, pero no se destruye físicamente.

cURL

curl -X DELETE "https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/rows/ROW_ID" \
  -H "Authorization: Bearer TU_API_KEY"

Node

await fetch(
  'https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/rows/ROW_ID',
  { method: 'DELETE', headers: { Authorization: 'Bearer TU_API_KEY' } }
);

Python

import requests

requests.delete(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/rows/ROW_ID",
    headers={"Authorization": "Bearer TU_API_KEY"},
)

Respuesta 200

{ "success": true, "message": "Fila eliminada" }

Operación sobre filas — upsert, aggregate y deleteMany

POST /workspaces/:workspaceId/databases/:dbId/tables/:tableId/rows/query Copiar

Un único endpoint para tres operaciones que no encajan en el CRUD simple, seleccionadas por operation.

Cuerpo de la petición

Campo	Tipo	Requerido	Descripción
operation	string	Sí	upsert, aggregate o deleteMany.
matchColumn	string	Solo upsert	Columna usada para buscar la fila existente.
data	object	Solo upsert	Datos a insertar o mezclar.
aggregateOp	string	No (solo aggregate)	count (por defecto), sum, avg, min o max.
column	string	Solo aggregate si aggregateOp ≠ count	Columna numérica sobre la que agregar.
filter	object	No	Mismo formato que en listar filas. Aplica a aggregate y deleteMany.

Precaución

deleteMany sin filter borra (lógicamente) todas las filas de la tabla — acótalo siempre con condiciones, igual que cualquier borrado masivo (ver la regla de borrado de datos del equipo).

cURL

# upsert: si ya existe una fila con sku="SKU-001", la actualiza; si no, la crea
curl -X POST "https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/rows/query" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "operation": "upsert",
    "matchColumn": "sku",
    "data": { "sku": "SKU-001", "stock": 40 }
  }'

Node

// aggregate: valor total de inventario (suma de precio * stock no aplica directo,
// aquí un ejemplo simple: suma de stock con filtro por categoría)
const res = await fetch(
  'https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/rows/query',
  {
    method: 'POST',
    headers: {
      Authorization: 'Bearer TU_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      operation: 'aggregate',
      aggregateOp: 'sum',
      column: 'stock',
      filter: { combinator: 'and', conditions: [{ column: 'categoria', operator: 'eq', value: 'Electrónica' }] },
    }),
  }
);

const { data } = await res.json();

Python

import requests

# deleteMany: borra (lógicamente) las filas sin stock
requests.post(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/rows/query",
    headers={"Authorization": "Bearer TU_API_KEY"},
    json={
        "operation": "deleteMany",
        "filter": {"combinator": "and", "conditions": [{"column": "stock", "operator": "eq", "value": 0}]},
    },
)

Respuesta 200 — upsert

{
  "success": true,
  "data": {
    "id": "row_ab12cd34ef",
    "sku": "SKU-001",
    "stock": 40,
    "_createdAt": "2026-06-18T09:00:00.000Z",
    "_updatedAt": "2026-06-18T09:12:00.000Z"
  }
}

Respuesta 200 — aggregate

{ "success": true, "data": { "value": 128 } }

Respuesta 200 — deleteMany

{ "success": true, "data": { "count": 3 } }

Importar filas

POST /workspaces/:workspaceId/databases/:dbId/tables/:tableId/import Copiar

Inserta varias filas en un solo lote. A diferencia de crear fila, aquí la validación es estricta: cada fila del lote debe cumplir todas las columnas requeridas (no se aplican valores por defecto salvo los que ya tenga la columna). Las filas que fallan no detienen el import — se reportan en errors y el resto se inserta igual.

Cuerpo de la petición

Campo	Tipo	Requerido	Descripción
rows	array de objetos	Sí	Cada elemento es un par columna: valor, con la misma forma que data en crear fila pero sin el envoltorio.

cURL

curl -X POST "https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/import" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "rows": [
      { "nombre": "Lámpara de escritorio", "precio": 299.0, "stock": 15, "categoria": "Hogar" },
      { "nombre": "Termo acero", "precio": 199.0, "stock": 50, "categoria": "Hogar" }
    ]
  }'

Node

const res = await fetch(
  'https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/import',
  {
    method: 'POST',
    headers: {
      Authorization: 'Bearer TU_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      rows: [
        { nombre: 'Lámpara de escritorio', precio: 299.0, stock: 15, categoria: 'Hogar' },
        { nombre: 'Termo acero', precio: 199.0, stock: 50, categoria: 'Hogar' },
      ],
    }),
  }
);

const { data } = await res.json();

Python

import requests

res = requests.post(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/databases/DB_ID/tables/TABLE_ID/import",
    headers={"Authorization": "Bearer TU_API_KEY"},
    json={
        "rows": [
            {"nombre": "Lámpara de escritorio", "precio": 299.0, "stock": 15, "categoria": "Hogar"},
            {"nombre": "Termo acero", "precio": 199.0, "stock": 50, "categoria": "Hogar"},
        ]
    },
)

result = res.json()["data"]

Respuesta 200

{
  "success": true,
  "data": {
    "inserted": 2,
    "errors": [],
    "total": 2
  }
}

Relacionado

• Flows y ejecuciones · Bases de datos (producto) · Nodo Database