API de Proyectos y Tableros

El módulo de Proyectos (Tableros estilo Monday) organiza trabajo en tableros con grupos, columnas tipadas e ítems. La API REST permite automatizar la creación de tareas desde otros sistemas (por ejemplo, crear un ítem cuando llega un ticket o se gana una oportunidad de CRM).

Requisitos

• El workspace debe tener el feature projects_enabled de su plan; sin él, los endpoints devuelven 403.
• Token Bearer del workspace.

Endpoints principales

• GET/POST /api/v1/boards — listar o crear tableros.
• GET /api/v1/boards/column-types — tipos de columna disponibles (texto, estado, persona, fecha, número, etc.).
• POST /api/v1/boards/{board}/groups — crear un grupo (sección) dentro del tablero.
• POST /api/v1/boards/{board}/columns — agregar una columna.
• POST /api/v1/boards/{board}/items — crear un ítem (tarea).
• PUT /api/v1/boards/items/{item}/columns/{column} — actualizar el valor de una columna en un ítem.
• PATCH /api/v1/boards/items/{item}/move — mover un ítem entre grupos.
• POST /api/v1/boards/items/{item}/subitems — crear subítems.

Ejemplo: crear un ítem en un tablero

curl -X POST "https://app.omnifox.io/api/v1/boards/8/items" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "title": "Preparar propuesta comercial",
        "group_id": 22,
        "contact_id": 55
      }'

Un ítem puede llevar contact_id y/o deal_id para enlazarlo con un contacto o una oportunidad del CRM.

Consejos

• Consultá GET /api/v1/boards/{board}/view para traer el tablero completo (grupos, columnas e ítems) en una sola llamada, ideal para dashboards externos.
• Las automatizaciones del tablero (/api/v1/boards/{board}/automations) pueden crear o mover ítems solas quen ocurre un evento; revisá el catálogo con GET .../automations/catalog antes de armar una regla nueva.

Solución de problemas

• 403 en /boards/*: el plan del workspace no incluye Proyectos.
• La columna no acepta el valor enviado: cada tipo de columna (estado, persona, fecha…) espera un formato distinto; consultá GET /api/v1/boards/column-types para ver el esquema exacto.
• El ítem no se mueve de grupo: usá PATCH .../move (no PUT) e incluí el group_id destino.