# Asana

## Overview

Asana is a work management platform for organizing tasks, projects, and workflows. Integrate with Asana to create and manage tasks, projects, and workspaces from Suger and to automate task workflows.

### Org-Level vs User-Level

> **Org-Level**: Uses an Asana Service Account token for organization-wide access. Best for shared, company-wide automation.
>
> **User-Level**: Uses OAuth to connect an individual's Asana account for personal task and project management.

## Create Integration (Org-Level)

### Prerequisites

- An Asana Enterprise-tier plan (Service Accounts are an Enterprise feature)
- Super admin access to create a Service Account (Admin console → **Apps** → **Service Accounts** → **Add Service Account**)

### Authenticate by Service Account Token

1. Navigate to Settings > Integrations
2. Click "Connect Asana"
3. Enter your Asana Service Account token
4. Verify the connection

:::warning
A Service Account token has organization-wide access to all data, including private user data. Treat it as a highly privileged secret.
:::

## Create User Integration

1. Click `Connect Now` in the User Integrations section
2. You will be redirected to Asana to authorize
3. Grant Suger access to your Asana account
4. Return to Suger and verify the connection

## Suger AI Tools

When Asana is connected, the Suger AI agent can manage work in Asana through Suger's built-in tools (43 actions). Capabilities are grouped below.

> **Org-level and user-level**: Both are supported; user-level takes precedence when both are connected.

| Capability | What the agent can do |
|------------|-----------------------|
| **Tasks** | Create, read, update, and delete tasks and subtasks, and search a workspace (e.g. `create-task`, `update-task`, `search-tasks-in-workspace`) |
| **Projects** | Manage projects and task–project membership (e.g. `create-project`, `add-project-to-task`) |
| **Sections** | Organize tasks into project sections (e.g. `create-section`, `list-tasks-for-section`) |
| **Tags** | Manage tags and attach or detach them on tasks (e.g. `create-tag`, `add-tag-to-task`) |
| **Stories & comments** | Add and read comment threads on tasks (e.g. `create-story-on-task`, `list-stories-for-task`) |
| **Workspaces, teams & users** | Read org structure and the connected account (e.g. `get-account`, `list-workspaces`, `list-users-for-workspace`) |

## Edit Integration

Editing is not supported. Delete and recreate.

## Delete Integration

Deleting removes the integration from Suger.

:::warning
This does not delete your data in Asana. For the org Service Account token, revoke or rotate it in the Asana Admin console → Apps → Service Accounts.
:::