ClickUp - Leer tarea

↩ Parte de la integración ClickUp.

Descripción

Lee una tarea de ClickUp por su id (GET /task/{task_id}) y le pasa el objeto completo al nodo siguiente. Sirve para consultar el estado actual antes de actuar: en qué estado está, quién la tiene asignada, si está vencida o qué dicen sus campos personalizados.

Configuración

Campo	Tipo	Obligatorio	Descripción
`credentials_id`	credentials	Sí	Credencial de ClickUp
`task_id`	texto	Sí	id de la tarea

task_id se resuelve con variables dinámicas ({{data.campo}}). Este nodo no tiene selector de campos: ClickUp devuelve la tarea entera.

Credenciales

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

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

Salida

La tarea tal como la devuelve ClickUp (recortada acá para que se lea mejor):

{
  "data": {
    "id": "86a1b2c3d",
    "name": "Pedido: ACME S.A.",
    "text_content": "3 unidades del SKU CAM-001",
    "status": { "status": "in progress", "type": "custom" },
    "date_created": "1786700000000",
    "due_date": "1786788000000",
    "priority": { "id": "2", "priority": "high" },
    "assignees": [ { "id": 4812345, "username": "ana", "email": "ana@acme.com" } ],
    "custom_fields": [],
    "list": { "id": "901300123456", "name": "Pedidos entrantes" },
    "url": "https://app.clickup.com/t/86a1b2c3d"
  },
  "_meta": {
    "moduleVersion": "1.0.0",
    "success": true,
    "id": "86a1b2c3d",
    "totalMs": 205
  }
}

Ojo con las fechas: vuelven como cadenas con milisegundos ("1786788000000"), que es como las serializa ClickUp.

Ejemplo de uso

{
  "credentials_id": "clickup_ops",
  "task_id": "{{data.task_id}}"
}

Un patrón habitual es Leer tarea → Decisión sobre {{data.status.status}}, para que el workflow siga solo cuando la tarea llegó a determinada etapa.

Notas

Una tarea inexistente, o que vive en un espacio al que tu token no accede, devuelve un error not_found (404) y detiene esa rama.
El id de la tarea es el código corto de su URL (app.clickup.com/t/86a1b2c3d). Si tu workspace usa ids personalizados, usá el id que ClickUp devuelve en el campo id.
La respuesta puede ser grande (asignados, checklists, campos personalizados, etiquetas) y se guarda en la traza de ejecución: evitá leer tareas dentro de un bucle amplio si solo necesitás un campo.

Nodos relacionados

ClickUp - Listar tareas — leé todas las tareas de una lista en vez de una.
ClickUp - Actualizar tarea — modificá lo que acabás de leer.
ClickUp - Comentar tarea — dejá una nota en la tarea.