API de Projetos e Quadros

O módulo de Projetos (quadros estilo Monday) organiza o trabalho em quadros com grupos, colunas tipadas e itens. A API REST permite automatizar a criação de tarefas a partir de outros sistemas — por exemplo, criar um item quando chega um chamado ou uma oportunidade do CRM é ganha.

Requisitos

• O workspace precisa ter o recurso projects_enabled habilitado pelo plano; sem ele, os endpoints retornam 403.
• Token Bearer do workspace.

Endpoints principais

• GET/POST /api/v1/boards — listar ou criar quadros.
• GET /api/v1/boards/column-types — tipos de coluna disponíveis (texto, status, pessoa, data, número etc.).
• POST /api/v1/boards/{board}/groups — criar um grupo (seção) dentro do quadro.
• POST /api/v1/boards/{board}/columns — adicionar uma coluna.
• POST /api/v1/boards/{board}/items — criar um item (tarefa).
• PUT /api/v1/boards/items/{item}/columns/{column} — atualizar o valor de uma coluna em um item.
• PATCH /api/v1/boards/items/{item}/move — mover um item entre grupos.
• POST /api/v1/boards/items/{item}/subitems — criar subitens.

Exemplo: criar um item em um quadro

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

Um item pode ter contact_id e/ou deal_id para vinculá-lo a um contato ou a uma oportunidade do CRM.

Dicas

• Chame GET /api/v1/boards/{board}/view para trazer o quadro inteiro (grupos, colunas e itens) em uma única chamada — ideal para dashboards externos.
• As automações do quadro (/api/v1/boards/{board}/automations) podem criar ou mover itens sozinhas quando um evento ocorre; confira o catálogo com GET .../automations/catalog antes de montar uma regra nova.

Solução de problemas

• 403 em /boards/*: o plano do workspace não inclui Projetos.
• A coluna não aceita o valor enviado: cada tipo de coluna (status, pessoa, data…) espera um formato diferente; consulte GET /api/v1/boards/column-types para ver o esquema exato.
• O item não muda de grupo: use PATCH .../move (não PUT) e inclua o group_id de destino.