Asana - Leer tarea

↩ Forma parte de la integración Asana.

Descripción

Lee una tarea por su gid (GET /tasks/{gid}) y le pasa el objeto de Asana al nodo siguiente. Sirve para comprobar si una tarea está completada, quién la tiene asignada o para cuándo vence, antes de decidir qué hace el workflow.

Podés acotar la respuesta con opt_fields, lo que mantiene el payload chico.

Configuración

Campo	Tipo	Requerido	Descripción
`credentials_id`	credencial	Sí	Credencial de Asana
`task_gid`	texto	Sí	`gid` de la tarea
`opt_fields`	texto	No	Campos a devolver, separados por coma (ej. `name,completed,assignee`)

task_gid acepta variables dinámicas. opt_fields se envía tal cual como parámetro de consulta.

Credenciales

Este módulo necesita una credencial Asana:

Campo	Descripción
`access_token`	Personal Access Token generado en app.asana.com
`default_workspace_gid`	Workspace de respaldo (opcional)

Salida

data es el objeto de la tarea tal como lo devuelve Asana:

{
  "gid": "1209876543210987",
  "resource_type": "task",
  "name": "Seguimiento: ACME S.A.",
  "notes": "Pidió presupuesto por 200 unidades.",
  "completed": false,
  "completed_at": null,
  "due_on": "2026-09-15",
  "assignee": { "gid": "1201111111111111", "resource_type": "user", "name": "Ana Ruiz" },
  "created_at": "2026-08-28T08:10:31.000Z",
  "permalink_url": "https://app.asana.com/0/1201234567890123/1209876543210987"
}

Y junto a él, _meta:

{ "moduleVersion": "1.0.0", "success": true, "gid": "1209876543210987", "totalMs": 172 }

Ejemplo de uso

Tarea completa

{
  "credentials_id": "asana_ops",
  "task_gid": "1209876543210987"
}

Solo lo que necesitás

{
  "credentials_id": "asana_ops",
  "task_gid": "{{data.gid}}",
  "opt_fields": "name,completed,assignee,due_on"
}

Los nodos siguientes referencian entonces {{data.completed}} o {{data.name}}.

Notas

La respuesta por defecto de Asana ya omite muchos campos. Si falta algo que esperabas (por ejemplo permalink_url o los campos personalizados), pedilo explícitamente en opt_fields.
El gid es una cadena. Guardalo como texto para no perder dígitos en una conversión numérica.
Un 404 significa que la tarea no existe o que la cuenta del token no puede verla. No se reintenta: revisá el gid y la pertenencia al proyecto.

Nodos relacionados

Asana: Listar tareas — traer todas las tareas de un proyecto en lugar de una.
Asana: Actualizar tarea — escribir sobre la tarea que acabás de leer.
Asana: Comentar tarea — dejarle una nota.