ClickUp - Actualizar tarea

↩ Parte de la integración ClickUp.

Descripción

Actualiza una tarea existente de ClickUp (PUT /task/{task_id}). Así es como un workflow hace avanzar una tarea por los estados de su lista —“to do” → “in progress” → “done”— y ajusta de paso fechas, prioridad o asignados.

Los campos a cambiar se pasan como un objeto JSON, de modo que un solo nodo cubre cualquier atributo editable sin un campo de formulario por atributo.

Configuración

Campo	Tipo	Obligatorio	Descripción
`credentials_id`	credentials	Sí	Credencial de ClickUp
`task_id`	texto	Sí	id de la tarea
`fields`	JSON	Sí	Campos a actualizar, ej. `{"status":"in progress"}`

task_id se resuelve con variables dinámicas ({{data.campo}}). fields no: se parsea como JSON y se envía como cuerpo de la petición, así que cualquier valor calculado hay que armarlo en un nodo anterior.

Credenciales

Este nodo requiere una credencial ClickUp (tipo de servicio clickup):

Campo	Descripción
`token`	Personal API token desde ClickUp → Settings → Apps → API Token

Campos que se actualizan con más frecuencia

Clave	Efecto
`status`	Mueve la tarea a ese estado (tiene que existir en su lista)
`name`	Renombra la tarea
`description`	Reemplaza la descripción
`priority`	`1` urgente, `2` alta, `3` normal, `4` baja
`due_date`	Fecha límite en milisegundos Unix
`start_date`	Fecha de inicio en milisegundos Unix
`assignees`	`{"add": [123], "rem": [456]}` — ClickUp agrega y quita, no reemplaza
`archived`	`true` archiva la tarea

Salida

La tarea actualizada, tal como la devuelve ClickUp:

{
  "data": {
    "id": "86a1b2c3d",
    "name": "Pedido: ACME S.A.",
    "status": { "status": "in progress", "type": "custom" },
    "date_updated": "1786790000000",
    "url": "https://app.clickup.com/t/86a1b2c3d"
  },
  "_meta": {
    "moduleVersion": "1.0.0",
    "success": true,
    "id": "86a1b2c3d",
    "totalMs": 271
  }
}

Ejemplo de uso

Avanzar el estado

{
  "credentials_id": "clickup_ops",
  "task_id": "{{data.task_id}}",
  "fields": { "status": "in progress" }
}

Subir la prioridad y correr la fecha límite

{
  "credentials_id": "clickup_ops",
  "task_id": "{{data.task_id}}",
  "fields": {
    "priority": 1,
    "due_date": 1786788000000
  }
}

Agregar y quitar asignados

{
  "credentials_id": "clickup_ops",
  "task_id": "{{data.task_id}}",
  "fields": {
    "assignees": { "add": [ 4812345 ], "rem": [ 4812346 ] }
  }
}

Notas

Si fields no es JSON válido, el nodo corta con un error de validation antes de llamar a ClickUp.
Solo cambian las claves que enviás; el resto conserva su valor actual.
Enviar un status que no existe en la lista de la tarea devuelve un error de validation (400) con el ECODE de ClickUp.
Para dar una tarea por terminada, poné el estado que tu lista usa como etapa final: no hay un flag genérico de “completada”.
Los campos personalizados no se actualizan por este endpoint; requieren POST /task/{id}/field/{field_id} con el nodo HTTP.

Nodos relacionados

ClickUp - Leer tarea — consultá los valores actuales antes de actualizar.
ClickUp - Crear tarea — dar de alta la tarea.
ClickUp - Borrar tarea — eliminarla de forma permanente.