> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Asana

> Organiza, sigue y gestiona el trabajo del equipo en Asana mediante tu cuenta conectada.

# Asana

Usa esta app cuando tu flujo de trabajo necesite elementos de trabajo de Asana, estructura de proyectos o actualizaciones de tareas. Puedes crear, leer y organizar tareas y proyectos desde otros pasos.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Etiqueta para el paso en el lienzo del flujo de trabajo. |
| Authentication | Yes | La cuenta de Asana conectada que se usará para este paso. |
| Action | Yes | La acción de Asana que se va a realizar (por ejemplo Get current user, Create task, Get task, Update task). |
| Arguments | Yes | Campos de formulario por acción generados a partir del esquema de entrada de la acción. Cada campo de texto tiene un botón **Insert Variable** para insertar valores `{{placeholder}}`. Hay una pestaña **Raw JSON** disponible para uso avanzado. |
| When the step fails | No | Controla si el flujo de trabajo debe **Terminate Workflow** o **Continue** si este paso falla. |

Antes de configurar este paso, conecta Asana en **Integrations** para tu espacio de trabajo usando el flujo de inicio de sesión. Si no hay ninguna conexión activa disponible, el paso muestra una advertencia con un enlace a **Integrations** en lugar del selector de cuenta.

## Arguments form

Cuando seleccionas una acción, la sección **Arguments** muestra un formulario impulsado por el esquema de entrada de la acción. Los campos que hacen referencia a registros existentes incluyen selectores desplegables.

Cambia a la pestaña **Raw JSON** cuando prefieras escribir el objeto completo de argumentos a mano. Los cambios en cualquiera de las pestañas se mantienen sincronizados.

## Common actions

| Action | Description |
| - | - |
| **Get current user** | Recupera el perfil de Asana del usuario autenticado y los espacios de trabajo a los que tiene acceso. |
| **Create task** | Crea una nueva tarea con un nombre, asignado, proyecto o elemento principal. |
| **Get task** | Recupera los detalles completos de una tarea por su GID. |
| **Update task** | Actualiza los campos de una tarea existente. |
| **Add tag to task** | Adjunta una etiqueta existente a una tarea. |
| **Get tags for task** | Enumera todas las etiquetas aplicadas a una tarea. |
| **Create project** | Crea un nuevo proyecto en un espacio de trabajo o equipo. |
| **Get project** | Recupera los detalles completos de un proyecto por su GID. |
| **Update project** | Actualiza los campos de un proyecto existente. |
| **Get tasks from project** | Enumera las tareas de un proyecto con filtros opcionales. |
| **Create section** | Crea una nueva sección en un proyecto. |
| **Get sections in project** | Enumera todas las secciones de un proyecto. |
| **Add task to section** | Mueve una tarea existente a una sección de proyecto. |
| **Create tag** | Crea una nueva etiqueta en un espacio de trabajo. |
| **Get tags in workspace** | Enumera todas las etiquetas disponibles en un espacio de trabajo. |

Las acciones destructivas, como eliminar registros, no están disponibles en el selector de acciones del flujo de trabajo.

## Output

Este paso almacena la respuesta de Asana como salida del paso. La forma de la respuesta depende de la acción.

Usa la referencia de salida completa en pasos posteriores:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Abre **Integrations** y conecta Asana si aún no lo has hecho.
2. Añade un paso de **Asana** a tu flujo de trabajo.
3. Selecciona una cuenta conectada en **Authentication**.
4. Elige **Get current user** en **Action**.
5. Rellena los campos requeridos. Usa **Insert Variable** para hacer referencia a la salida de un paso anterior en cualquier valor de campo.
6. Haz clic en **Run** en el encabezado del paso para probar la acción y luego revisa la carga útil devuelta en **Output**.

## Use cases

### Create a task from a request

1. Create task
2. Add tag to task
3. Get task

### Organize project work

1. Create section
2. Get sections in project
3. Add task to section

### Review project status

1. Get project
2. Get tasks from project
3. Update project

## Notes

* Este paso depende de una integración de Asana conectada en tu espacio de trabajo.
* El selector de acciones del flujo de trabajo muestra un conjunto curado de acciones. Los agentes con la herramienta de Asana pueden usar más de ellas.
* La pantalla de inicio de sesión puede mostrar la marca de autorización de terceros.

## Using Asana as an Agent Tool

También puedes añadir Asana como herramienta en el **Agent Editor**. Abre el agente, haz clic en **Add tool** y selecciona **Asana**. En el panel de configuración de la herramienta, elige la cuenta conectada que el agente debe usar. El agente llama a las acciones de Asana cuando son relevantes para la conversación.

See also: [Integrations](https://docs.fetchhive.com/es/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/es/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/es/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.