---
title: Asana
description: Interactúa con Asana
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="asana"
  color="#E0E0E0"
/>

## Instrucciones de uso

Integra Asana en el flujo de trabajo. Puede leer, escribir y actualizar tareas.

## Herramientas

### `asana_get_task`

Recupera una tarea individual por GID u obtén múltiples tareas con filtros

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ----------- | ----------- |
| `taskGid` | string | No | El identificador único global \(GID\) de la tarea. Si no se proporciona, obtendrá múltiples tareas. |
| `workspace` | string | No | GID del espacio de trabajo para filtrar tareas \(requerido cuando no se usa taskGid\) |
| `project` | string | No | GID del proyecto para filtrar tareas |
| `limit` | number | No | Número máximo de tareas a devolver \(predeterminado: 50\) |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `ts` | string | Marca de tiempo de la respuesta |
| `gid` | string | Identificador único global de la tarea |
| `resource_type` | string | Tipo de recurso \(tarea\) |
| `resource_subtype` | string | Subtipo de recurso |
| `name` | string | Nombre de la tarea |
| `notes` | string | Notas o descripción de la tarea |
| `completed` | boolean | Si la tarea está completada |
| `assignee` | object | Detalles del asignado |

### `asana_create_task`

Crear una nueva tarea en Asana

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `workspace` | string | Sí | GID del espacio de trabajo donde se creará la tarea |
| `name` | string | Sí | Nombre de la tarea |
| `notes` | string | No | Notas o descripción para la tarea |
| `assignee` | string | No | GID del usuario al que se asignará la tarea |
| `due_on` | string | No | Fecha de vencimiento en formato AAAA-MM-DD |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `ts` | string | Marca de tiempo de la respuesta |
| `gid` | string | Identificador único global de la tarea |
| `name` | string | Nombre de la tarea |
| `notes` | string | Notas o descripción de la tarea |
| `completed` | boolean | Si la tarea está completada |
| `created_at` | string | Marca de tiempo de creación de la tarea |
| `permalink_url` | string | URL a la tarea en Asana |

### `asana_update_task`

Actualizar una tarea existente en Asana

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `taskGid` | string | Sí | El identificador único global (GID) de la tarea a actualizar |
| `name` | string | No | Nombre actualizado para la tarea |
| `notes` | string | No | Notas o descripción actualizadas para la tarea |
| `assignee` | string | No | GID del usuario asignado actualizado |
| `completed` | boolean | No | Marcar tarea como completada o no completada |
| `due_on` | string | No | Fecha de vencimiento actualizada en formato AAAA-MM-DD |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `ts` | string | Marca de tiempo de la respuesta |
| `gid` | string | Identificador único global de la tarea |
| `name` | string | Nombre de la tarea |
| `notes` | string | Notas o descripción de la tarea |
| `completed` | boolean | Si la tarea está completada |
| `modified_at` | string | Marca de tiempo de última modificación de la tarea |

### `asana_get_projects`

Recuperar todos los proyectos de un espacio de trabajo de Asana

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `workspace` | string | Sí | GID del espacio de trabajo del que recuperar los proyectos |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `ts` | string | Marca de tiempo de la respuesta |
| `projects` | array | Array de proyectos |

### `asana_search_tasks`

Buscar tareas en un espacio de trabajo de Asana

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | -------- | ----------- |
| `workspace` | string | Sí | GID del espacio de trabajo donde buscar tareas |
| `text` | string | No | Texto a buscar en los nombres de las tareas |
| `assignee` | string | No | Filtrar tareas por GID del usuario asignado |
| `projects` | array | No | Array de GIDs de proyectos para filtrar tareas |
| `completed` | boolean | No | Filtrar por estado de finalización |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `ts` | string | Marca de tiempo de la respuesta |
| `tasks` | array | Array de tareas coincidentes |

### `asana_add_comment`

Añadir un comentario (historia) a una tarea de Asana

#### Entrada

| Parámetro | Tipo | Obligatorio | Descripción |
| --------- | ---- | ---------- | ----------- |
| `taskGid` | string | Sí | El identificador único global \(GID\) de la tarea |
| `text` | string | Sí | El contenido de texto del comentario |

#### Salida

| Parámetro | Tipo | Descripción |
| --------- | ---- | ----------- |
| `success` | boolean | Estado de éxito de la operación |
| `ts` | string | Marca de tiempo de la respuesta |
| `gid` | string | Identificador único global del comentario |
| `text` | string | Contenido de texto del comentario |
| `created_at` | string | Marca de tiempo de creación del comentario |
| `created_by` | object | Detalles del autor del comentario |

## Notas

- Categoría: `tools`
- Tipo: `asana`
