Monday.com - Actualizar ítem

↩ Parte de la integración Monday.com.

Descripción

Este módulo actualiza una o varias columnas de un ítem con la mutation GraphQL change_multiple_column_values:

mutation($board_id: ID!, $item_id: ID!, $column_values: JSON!) {
  change_multiple_column_values(board_id: $board_id, item_id: $item_id, column_values: $column_values) {
    id
    name
  }
}

La actualización es parcial: solo cambian las columnas presentes en column_values. Monday necesita el id del tablero además del id del ítem, así que acá los dos campos son obligatorios.

Configuración

Campo	Tipo	Obligatorio	Descripción
`credentials_id`	credentials	Sí	Credencial de Monday
`board_id`	text	Sí	ID numérico del tablero
`item_id`	text	Sí	ID numérico del ítem
`column_values`	json	Sí	Valores de columnas a escribir, como JSON

Credenciales

Este módulo requiere una credencial de tipo Monday.

Campo	Descripción
`token`	Token personal de la API (Avatar → Developers → My access tokens)
`timeout`	Opcional. Tiempo máximo de la petición en milisegundos (por defecto 20000)

Salida

{
  "nextModule": null,
  "data": { "id": "987654321", "name": "Acme S.A." },
  "_meta": {
    "moduleVersion": "1.0.0",
    "success": true,
    "id": "987654321",
    "totalMs": 288
  }
}

Ejemplo de uso

Pasar una oportunidad a “Hecho”

{
  "credentials_id": 8,
  "board_id": "1234567890",
  "item_id": "{{data.id}}",
  "column_values": {
    "status":  { "label": "Hecho" },
    "date4":   { "date": "2026-03-05" },
    "numbers": "4200"
  }
}

Asignar un responsable y dejar una nota

{
  "credentials_id": 8,
  "board_id": "1234567890",
  "item_id": "{{data.id}}",
  "column_values": {
    "person": { "personsAndTeams": [ { "id": 12345678, "kind": "person" } ] },
    "text":   "Revisado automáticamente por el flujo"
  }
}

Notas

Acá column_values es obligatorio. Sin él, el nodo se detiene con un error de tipo validation y nunca llama a Monday.
Las claves son ids de columna. Ejecutá Leer ítem una vez contra un ítem real para descubrirlos.
Para vaciar una columna, enviá su forma vacía, por ejemplo { "status": {} } o { "text": "" }.
Monday devuelve HTTP 200 incluso cuando la mutation falla. Un valor con la forma equivocada lanza un ColumnValueException, que el nodo expone como error de validación y no reintenta.
Pasar un board_id que no es el dueño del item_id es un error del lado de Monday, no una operación que se ignora en silencio.

Nodos relacionados

Monday.com - Leer ítem — consultá primero los valores actuales y los ids de columna.
Monday.com - Crear ítem — creá el ítem en lugar de actualizarlo.
Monday.com - Agregar update — dejá un comentario explicando el cambio.