> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.airweave.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.airweave.ai/_mcp/server.
# Asana
> Asana integration with Airweave
{/* AUTO-GENERATED CONTENT START */}
Asana
This connector enables AI agents and RAG systems to retrieve context from Asana through Airweave's unified search layer.
## Configuration
Asana source connector — syncs workspaces, projects, tasks, sections, comments, files.
#### [View Source Code](https://github.com/airweave-ai/airweave/tree/main/backend/airweave/platform/sources/asana.py)
Explore the Asana connector implementation
### Authentication
This connector uses **OAuth 2.0 authentication**. You can connect through the Airweave UI or API using the OAuth flow.
**Supported authentication methods:**
* OAuth Browser Flow (recommended for UI)
* OAuth Token (for programmatic access)
* Auth Provider (enterprise SSO)
### Configuration Options
This connector does not have any additional configuration options.
## Data Models
The following data models are available for this connector:
#### AsanaWorkspaceEntity
Schema for Asana workspace entities.
| Field | Type | Description |
| ---------------- | -------------- | ---------------------------------------------------- |
| gid | str | Asana workspace GID |
| name | str | Workspace name |
| is\_organization | bool | Whether the workspace is an organization |
| email\_domains | List\[str] | List of email domains that can access this workspace |
| permalink\_url | Optional\[str] | URL to access the workspace in the Asana application |
#### AsanaProjectEntity
Schema for Asana project entities.
| Field | Type | Description |
| ----------------------- | ------------------- | ------------------------------------------------------------------ |
| gid | str | Asana project GID |
| name | str | Project name |
| created\_at | Optional\[datetime] | Created at |
| modified\_at | Optional\[datetime] | Last modified at |
| workspace\_gid | str | Globally unique identifier of the workspace the project belongs to |
| workspace\_name | str | The name of the workspace the project belongs to |
| color | Optional\[str] | Color of the project (e.g. 'dark-pink', 'light-blue') |
| archived | bool | Whether the project is archived |
| current\_status | Optional\[Dict] | The current status update for this project |
| default\_view | Optional\[str] | The default view of the project (list, board, calendar, timeline) |
| due\_date | Optional\[str] | The day on which this project is due (YYYY-MM-DD format) |
| due\_on | Optional\[str] | The day on which this project is due (YYYY-MM-DD format) |
| html\_notes | Optional\[str] | HTML formatted note content of the project |
| notes | Optional\[str] | Free-form textual information associated with the project |
| is\_public | bool | Whether the project is public to its team |
| start\_on | Optional\[str] | The day on which this project starts (YYYY-MM-DD format) |
| owner | Optional\[Dict] | The owner of this project |
| team | Optional\[Dict] | The team that this project is associated with |
| members | List\[Dict] | Array of users who are members of this project |
| followers | List\[Dict] | Array of users following this project |
| custom\_fields | List\[Dict] | Array of custom field values applied to the project |
| custom\_field\_settings | List\[Dict] | Array of custom field settings for this project |
| default\_access\_level | Optional\[str] | Default access level for the project (editor, commenter, viewer) |
| icon | Optional\[str] | The icon for a project |
| permalink\_url | Optional\[str] | URL to access the project in the Asana application |
#### AsanaSectionEntity
Schema for Asana section entities.
| Field | Type | Description |
| ------------ | ------------------- | ----------------------------------------------------------------- |
| gid | str | Asana section GID |
| name | str | Section name |
| created\_at | Optional\[datetime] | Created at |
| project\_gid | str | Globally unique identifier of the project this section belongs to |
| projects | List\[Dict] | Deprecated. Array of projects this section is associated with |
#### AsanaTaskEntity
Schema for Asana task entities.
| Field | Type | Description |
| --------------------------- | ------------------- | ----------------------------------------------------------------- |
| gid | str | Asana task GID |
| name | str | Task name |
| created\_at | Optional\[datetime] | Created at |
| modified\_at | Optional\[datetime] | Last modified at |
| project\_gid | str | Globally unique identifier of the project this task belongs to |
| section\_gid | Optional\[str] | Globally unique identifier of the section this task belongs to |
| actual\_time\_minutes | Optional\[int] | The actual time spent on this task in minutes |
| approval\_status | Optional\[str] | The status of the task's approval, if applicable |
| assignee | Optional\[Dict] | User to which this task is assigned |
| assignee\_status | Optional\[str] | The scheduling status of this task for the user it's assigned to |
| completed | bool | Whether the task is marked complete |
| completed\_at | Optional\[datetime] | The time at which this task was completed |
| completed\_by | Optional\[Dict] | The user who completed this task |
| dependencies | List\[Dict] | Array of tasks that this task depends on |
| dependents | List\[Dict] | Array of tasks that depend on this task |
| due\_at | Optional\[datetime] | The time at which this task is due with a time component |
| due\_on | Optional\[str] | The date on which this task is due (YYYY-MM-DD format) |
| external | Optional\[Dict] | Information about the external application syncing with this task |
| html\_notes | Optional\[str] | HTML formatted note content of the task |
| notes | Optional\[str] | Free-form textual information associated with the task |
| is\_rendered\_as\_separator | bool | Whether the task is rendered as a separator in list view |
| liked | bool | Whether the task is liked by the authorized user |
| memberships | List\[Dict] | Array of projects and sections this task is in |
| num\_likes | int | The number of users who have liked this task |
| num\_subtasks | int | The number of subtasks on this task |
| parent | Optional\[Dict] | The parent of this task, if applicable |
| permalink\_url | Optional\[str] | URL to access the task in the Asana application |
| resource\_subtype | str | The subtype of the task (default\_task, milestone, approval) |
| start\_at | Optional\[datetime] | The time at which this task starts with a time component |
| start\_on | Optional\[str] | The date on which this task starts (YYYY-MM-DD format) |
| tags | List\[Dict] | Array of tags associated with this task |
| custom\_fields | List\[Dict] | Array of custom field values applied to the task |
| followers | List\[Dict] | Array of users following this task |
| workspace | Optional\[Dict] | The workspace this task is associated with |
#### AsanaCommentEntity
Schema for Asana comment/story entities.
| Field | Type | Description |
| ----------------- | ------------------- | -------------------------------------------------------------- |
| gid | str | Asana comment GID |
| created\_at | Optional\[datetime] | Created at |
| task\_gid | str | Globally unique identifier of the task this comment belongs to |
| author | Dict | The user who created this comment |
| resource\_subtype | str | The subtype of the comment resource |
| text | Optional\[str] | The plain text content of the comment |
| html\_text | Optional\[str] | HTML formatted content of the comment |
| is\_pinned | bool | Whether the comment is pinned to the task |
| is\_edited | bool | Whether the comment has been edited |
| sticker\_name | Optional\[str] | The name of the sticker (for sticker comments) |
| num\_likes | int | The number of users who have liked this comment |
| liked | bool | Whether the comment is liked by the authorized user |
| type | str | The type of the comment (comment or system) |
| previews | List\[Dict] | Previews of attachments referenced in the comment |
#### AsanaFileEntity
Schema for Asana file attachments.
Reference:
[https://developers.asana.com/reference/getattachment](https://developers.asana.com/reference/getattachment)
| Field | Type | Description |
| -------------- | -------------------------- | --------------------------------------------- |
| gid | str | Asana file attachment GID |
| name | str | File name |
| created\_at | Optional\[datetime] | Created at |
| task\_gid | str | GID of the task this file is attached to |
| task\_name | str | Name of the task this file is attached to |
| project\_gid | Optional\[str] | GID of the project (for web URL construction) |
| resource\_type | str | Type of the attachment resource |
| host | Optional\[str] | Service hosting the attachment |
| parent | Optional\[Dict\[str, Any]] | Parent resource the attachment is on |
| view\_url | Optional\[str] | URL to view the attachment in browser |
| permanent | bool | Whether this is a permanent attachment |
{/* AUTO-GENERATED CONTENT END */}