> ## 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

> Organize, track, and manage team work in Asana via your connected account.

Use this app when your workflow needs Asana work items, project structure, or task updates. You can create, read, and organize tasks and projects from other steps.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| Authentication | Yes | The connected Asana account to use for this step. |
| Action | Yes | The Asana action to perform (for example Get current user, Create task, Get task, Update task). |
| Arguments | Yes | Per-action form fields generated from the action's schema. Each text field has an **Insert Variable** button for injecting `{{placeholder}}` values. A **Raw JSON** tab is available for advanced usage. |
| When the step fails | No | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails. |

Before you configure this step, connect Asana in **Integrations** for your workspace using the sign-in flow. If no active connection is available, the step shows a warning with a link to **Integrations** instead of the account selector.

## Arguments form

When you select an action, the **Arguments** section renders a form driven by the action's input schema. Fields that refer to existing records include dropdown pickers.

Switch to the **Raw JSON** tab when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

## Common actions

| Action | Description |
| - | - |
| **Get current user** | Retrieve the authenticated user's Asana profile and accessible workspaces. |
| **Create task** | Create a new task with a name, assignee, project, or parent. |
| **Get task** | Retrieve full details for a task by its GID. |
| **Update task** | Update fields on an existing task. |
| **Add tag to task** | Attach an existing tag to a task. |
| **Get tags for task** | List all tags applied to a task. |
| **Create project** | Create a new project in a workspace or team. |
| **Get project** | Retrieve full details for a project by its GID. |
| **Update project** | Update fields on an existing project. |
| **Get tasks from project** | List tasks in a project with optional filters. |
| **Create section** | Create a new section in a project. |
| **Get sections in project** | List all sections in a project. |
| **Add task to section** | Move an existing task into a project section. |
| **Create tag** | Create a new tag in a workspace. |
| **Get tags in workspace** | List all tags available in a workspace. |

Destructive actions, such as deleting records, are not available in the workflow action picker.

## Output

This step stores the Asana response as the step output. The shape of the response depends on the action.

Use the full output reference in later steps:

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

## Example

1. Open **Integrations** and connect Asana if you have not already done that.
2. Add an **Asana** step to your workflow.
3. Select a connected account in **Authentication**.
4. Choose **Get current user** in **Action**.
5. Fill in the required fields. Use **Insert Variable** to reference an earlier step's output for any field value.
6. Click **Run** in the step header to test the action, then review the returned payload in **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

* This step depends on a connected Asana integration in your workspace.
* The workflow action picker shows a curated set of actions. Agents with the Asana tool can use more of them.
* The sign-in screen may show third-party authorization branding.

## Using Asana as an Agent Tool

You can also add Asana as a tool in the **Agent Editor**. Open the agent, click **Add tool**, and select **Asana**. In the tool settings panel, choose the connected account the agent should use. The agent calls Asana actions when they are relevant to the conversation.

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


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