> ## Documentation Index > Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt > Use this file to discover all available pages before exploring further. # Toolkit de Asana > Interactúa con proyectos, tareas y usuarios de Asana desde dentro de un flujo de trabajo. El **Toolkit de Asana** permite que sus flujos de trabajo interactúen con Asana — recuperando proyectos, tareas, usuarios y espacios de trabajo, así como creando y actualizando tareas. ## Autenticación Todas las herramientas de Asana requieren una conexión de cuenta de Asana. Cada herramienta incluye un selector de **Cuenta de Asana** con dos opciones: | Opción | Descripción | | --------------------------- | -------------------------------------------------------------------------- | | **Usar mi cuenta de Asana** | Usa su cuenta personal de Asana conectada. | | **Usar cuenta de equipo** | Usa una cuenta de equipo compartida de Asana configurada para el proyecto. | Si no hay una cuenta conectada, haga clic en **Conectar cuenta de Asana** para autenticar. ## Herramientas ### Obtener proyectos de Asana Recupera todos los proyectos accesibles para la cuenta de Asana conectada. | Campo | Obligatorio | Descripción | | ------------------- | ----------- | --------------------------------------------------- | | **Cuenta de Asana** | Sí | Seleccione su cuenta personal o de equipo de Asana. | ### Obtener usuarios de Asana Recupera todos los usuarios en el espacio de trabajo de Asana conectado. | Campo | Obligatorio | Descripción | | ------------------- | ----------- | --------------------------------------------------- | | **Cuenta de Asana** | Sí | Seleccione su cuenta personal o de equipo de Asana. | ### Obtener espacios de trabajo de Asana Recupera todos los espacios de trabajo accesibles para la cuenta de Asana conectada. | Campo | Obligatorio | Descripción | | ------------------- | ----------- | --------------------------------------------------- | | **Cuenta de Asana** | Sí | Seleccione su cuenta personal o de equipo de Asana. | ### Obtener campos personalizados de Asana Recupera las definiciones de campos personalizados configurados para un proyecto específico de Asana. | Campo | Obligatorio | Descripción | | ------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------ | | **Cuenta de Asana** | Sí | Seleccione su cuenta personal o de equipo de Asana. | | **ID del proyecto** | Sí | El ID del proyecto del que obtener las definiciones de campos personalizados. Escriba `@` para seleccionar una variable. | ### Obtener tareas de Asana Recupera tareas de un proyecto específico de Asana con filtros opcionales para asignatario, espacio de trabajo y paginación. | Campo | Obligatorio | Descripción | | ---------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | **Cuenta de Asana** | Sí | Seleccione su cuenta personal o de equipo de Asana. | | **ID del proyecto** | Sí | El ID del proyecto del que obtener tareas. Escriba `@` para seleccionar una variable. | | **Límite** | No | Número máximo de tareas a devolver por solicitud API. El valor predeterminado es `50`. | | **Asignatario** | No | Filtra tareas por ID de usuario o correo electrónico del asignatario. El valor predeterminado es `null`. | | **Espacio de trabajo** | No | Filtra tareas por ID del espacio de trabajo. Usa el espacio de trabajo predeterminado si no se proporciona. El valor predeterminado es `null`. | | **Desplazamiento** | No | Token de desplazamiento inicial para la paginación. Generalmente no es necesario ya que obtiene todas las páginas. El valor predeterminado es `null`. | ### Obtener tareas de usuario de Asana Recupera todas las tareas asignadas a un usuario específico en Asana. | Campo | Obligatorio | Descripción | | ---------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | **Cuenta de Asana** | Sí | Seleccione su cuenta personal o de equipo de Asana. | | **Asignatario** | Sí | El ID de usuario o dirección de correo electrónico para obtener las tareas. Escriba `@` para seleccionar una variable. | | **Espacio de trabajo** | No | ID del espacio de trabajo en el que buscar. Usa el espacio de trabajo predeterminado si no se proporciona. El valor predeterminado es `null`. | | **Límite** | No | Número máximo de tareas a devolver por solicitud API. El valor predeterminado es `50`. | | **Desplazamiento** | No | Token de desplazamiento inicial para la paginación. Generalmente no es necesario ya que obtiene todas las páginas. El valor predeterminado es `null`. | ### Crear tarea de Asana Crea una nueva tarea en un proyecto específico de Asana. | Campo | Obligatorio | Descripción | | ------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Cuenta de Asana** | Sí | Seleccione su cuenta personal o de equipo de Asana. | | **ID del proyecto** | Sí | El ID del proyecto donde se creará la tarea. Escriba `@` para seleccionar una variable. | | **Nombre** | Sí | El nombre/título de la tarea. Escriba `@` para seleccionar una variable. | | **Notas** | No | Descripción o notas para la tarea. El valor predeterminado es `null`. | | **Asignatario** | No | Correo electrónico o ID de la persona a la que se asignará la tarea. El valor predeterminado es `null`. | | **Fecha de vencimiento** | No | Fecha de vencimiento en formato ISO (`YYYY-MM-DD`) o cualquier formato de fecha analizable. El valor predeterminado es `null`. | | **Etiquetas** | No | Array de nombres de etiquetas o GIDs de etiquetas para asignar a la tarea. El valor predeterminado es `null`. | | **Campos personalizados** | No | Campos personalizados como diccionario. Formato: `{"field_gid": "valor"}` o `{"field_name": "valor"}`. Para campos de enumeración, use el GID o nombre de la opción de enumeración. El valor predeterminado es `null`. | ### Actualizar tarea de Asana Actualiza una tarea existente de Asana por su ID. | Campo | Obligatorio | Descripción | | ------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Cuenta de Asana** | Sí | Seleccione su cuenta personal o de equipo de Asana. | | **ID de tarea** | Sí | El ID de la tarea a actualizar. Escriba `@` para seleccionar una variable. | | **Nombre** | No | Nuevo nombre/título para la tarea. El valor predeterminado es `null`. | | **Notas** | No | Nueva descripción o notas para la tarea. El valor predeterminado es `null`. | | **Completada** | No | Marca la tarea como completada (`true`) o incompleta (`false`). El valor predeterminado es `null`. | | **Campos personalizados** | No | Campos personalizados a actualizar como diccionario. Formato: `{"field_gid": "valor"}` o `{"field_name": "valor"}`. El valor predeterminado es `null`. |