Documentación API

La API pública de Mind One permite integrar la plataforma con sistemas externos de forma programática. Está autenticada mediante API Keys (Bearer token) y sigue el estándar REST.

API Interactiva → docs.getmindapp.io/api/

URL base

https://api.getmindapp.io/api/v1/public

Autenticación

Todas las llamadas requieren una API Key en la cabecera Authorization:

Authorization: Bearer mk_xxxxxxxxxxxxxxxxxxxxxxxx

Cada usuario genera y gestiona sus propias API Keys desde Perfil → API Keys. El prefijo mk_ identifica las claves de Mind One. La clave hereda el rol del usuario, y ese rol determina qué operaciones permite.

Nunca expongas tu API Key en código cliente (frontend). Úsala únicamente desde entornos de servidor o pipelines seguros.

Formato de respuesta

Todas las respuestas siguen el mismo patrón:

{
  "data": [ ... ],
  "meta": {
    "total": 100,
    "page": 1,
    "pageSize": 20,
    "totalPages": 5
  }
}

Para respuestas de un único recurso, data contiene el objeto directamente en lugar de un array.

Paginación

Los endpoints que devuelven listas soportan paginación mediante query params:

Parámetro	Tipo	Descripción
`page`	`number`	Número de página (base 1). Por defecto: `1`.
`limit`	`number`	Ítems por página. Máximo: `200`. Por defecto: `20`.

El objeto meta de la respuesta incluye:

Campo	Tipo	Descripción
`total`	`number`	Total de ítems en el resultado
`page`	`number`	Página actual
`pageSize`	`number`	Ítems devueltos en esta página
`totalPages`	`number`	Total de páginas disponibles

Ejemplo:

GET /workspaces?page=2&limit=50

Códigos de estado HTTP

Código	Significado
`200`	OK — Solicitud correcta
`201`	Created — Recurso creado
`204`	No Content — Eliminación correcta
`400`	Bad Request — Datos de entrada inválidos
`401`	Unauthorized — API Key ausente o inválida
`403`	Forbidden — Sin permisos o cuenta suspendida
`404`	Not Found — Recurso no encontrado
`409`	Conflict — Conflicto (p. ej. clave duplicada)
`429`	Too Many Requests — Rate limit alcanzado
`500`	Internal Server Error — Error interno del servidor

Referencia de Errores → docs.getmindapp.io/api/errors/

Rate limiting

La API aplica límites de peticiones por API Key. Al superar el límite recibirás un 429 Too Many Requests.

Se recomienda implementar backoff exponencial en tus integraciones: espera un tiempo creciente entre reintentos en lugar de reintentar inmediatamente.

Ejemplos rápidos

Crear un workspace:

curl -X POST https://api.getmindapp.io/api/v1/public/workspaces \
  -H "Authorization: Bearer mk_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Clientes",
    "description": "Datos maestros de clientes"
  }'

Listar workspaces:

curl "https://api.getmindapp.io/api/v1/public/workspaces?page=1&limit=20" \
  -H "Authorization: Bearer mk_tu_api_key"

Listar registros de una hoja:

curl "https://api.getmindapp.io/api/v1/public/datagrids/{datagridId}/rows?page=1&limit=50" \
  -H "Authorization: Bearer mk_tu_api_key"

Relacionado

Conexiones — Sincronización automática con data warehouses vía Autosync.
Usuarios y Roles — Cada usuario genera sus propias API Keys; su rol determina qué operaciones permiten.

Servidor MCP Webhooks